shield_lock
JinDaGe
Contact
← Back to MCP directory
publicPublicdnsLocal runtime

mcp-google-calendar

一个实现MCP协议的服务器，允许AI助手通过Google Calendar API创建和管理日历事件，支持OAuth2认证和事件管理功能。

article

README

🚀 MCP 谷歌日历服务器

MCP 谷歌日历服务器实现了模型上下文协议（MCP），能让 AI 助手（如 Claude）创建和管理谷歌日历事件，为日历管理带来了极大便利。

🚀 快速开始

MCP 谷歌日历服务器可让 AI 助手轻松与谷歌日历交互。通过以下步骤，你可以快速搭建并运行该服务器。

✨ 主要特性

  • 活动创建：可创建带有标题、描述、开始/结束时间的日历活动。
  • 参与者添加：支持为活动添加参与者。
  • 安全认证：采用 OAuth2 身份验证，与 Google Calendar API 集成，保障数据安全。
  • 协议完整：实现了完整的 MCP 协议。
  • 调试便利：提供调试日志，便于故障排除。

📦 安装指南

先决条件

  • Node.js v18 或更高版本。
  • 启用了谷歌云控制台项目的日历 API。
  • OAuth2 凭证（客户端 ID 和客户端密钥）。

安装步骤

  1. 克隆仓库：
git clone [https://github.com/markelaugust74/mcp-google-calendar.git]
cd mcp-google-calendar
  1. 安装依赖项：
npm install
  1. 配置环境变量：
    • 复制 .env.example 文件为 .env。
    • 添加您的谷歌 OAuth2 凭证。
  2. 获取刷新令牌：
npm run auth
  1. 更新 index.js 中的刷新令牌。

💻 使用示例

基础用法

启动服务器：

npm start
help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client