Calendar MCP Server

一个用于 Claude Desktop 中 Google 日历集成的模型上下文协议 (MCP) 服务器。该服务器使 AI 助手能够通过自然语言交互来管理 Google 日历事件。

功能

• 创建包含标题、时间、描述和地点的日历事件
• 通过事件 ID 检索事件详细信息
• 更新现有事件（标题、时间、描述、地点）
• 删除事件
• 列出指定时间范围内的事件
• 与 Google Calendar API 完全集成
• 安全的 OAuth2 身份验证

安装

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 Google Calendar 集成：

npx -y @smithery/cli install @gongrzhe/server-calendar-mcp --client claude

手动安装

npm install @gongrzhe/server-calendar-mcp

设置

1. 创建一个 Google Cloud 项目并获取凭据：

   a. 创建一个 Google Cloud 项目：

   • 转到 Google Cloud Console
   • 创建一个新项目或选择一个现有项目
   • 为您的项目启用 Google Calendar API

   b. 创建 OAuth 2.0 凭据：

   • 转到“API 和服务”>“凭据”
   • 单击“创建凭据”>“OAuth 客户端 ID”
   • 选择“桌面应用”作为应用程序类型
   • 给它一个名称，然后单击“创建”
   • 您将获得您的 GOOGLE_CLIENT_ID 和 GOOGLE_CLIENT_SECRET

   c. 获取刷新令牌：

   • 转到 OAuth 2.0 Playground
   • 单击右上角的齿轮图标（设置）
   • 选中“使用您自己的 OAuth 凭据”
   • 输入您的 OAuth 客户端 ID 和客户端密钥
   • 在左侧面板中，找到“Calendar API v3”并选择“https://www.googleapis.com/auth/calendar”
   • 单击“授权 API”并完成 OAuth 流程
   • 单击“Exchange authorization code for tokens”
   • 复制“刷新令牌” - 这是您的 GOOGLE_REFRESH_TOKEN

2. 在 Claude Desktop 中配置：

{
  "calendar": {
    "command": "npx",
    "args": [
      "@gongrzhe/server-calendar-mcp"
    ],
    "env": {
      "GOOGLE_CLIENT_ID": "your_client_id_here",
      "GOOGLE_CLIENT_SECRET": "your_client_secret_here",
      "GOOGLE_REFRESH_TOKEN": "your_refresh_token_here"
    }
  }
}

使用示例

该服务器提供了几个可以通过 Claude Desktop 使用的工具：

创建事件

{
  "summary": "Team Meeting",
  "start": {
    "dateTime": "2024-01-20T10:00:00Z"
  },
  "end": {
    "dateTime": "2024-01-20T11:00:00Z"
  },
  "description": "Weekly team sync",
  "location": "Conference Room A"
}

列出事件

{
  "timeMin": "2024-01-01T00:00:00Z",
  "timeMax": "2024-12-31T23:59:59Z",
  "maxResults": 10,
  "orderBy": "startTime"
}

更新事件

{
  "eventId": "event123",
  "summary": "Updated Meeting Title",
  "start": {
    "dateTime": "2024-01-20T11:00:00Z"
  },
  "end": {
    "dateTime": "2024-01-20T12:00:00Z"
  }
}

删除事件

{
  "eventId": "event123"
}

安全注意事项

• 确保您的 Google API 凭据安全
• 定期轮换您的刷新令牌
• 将敏感信息存储在 Claude Desktop 配置中
• 切勿共享或将您的凭据提交到版本控制
• 刷新令牌可以访问您的 Google 日历，请像密码一样对待它

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

该项目已获得 ISC 许可证的许可。

作者

gongrzhe

支持

如果您遇到任何问题或有疑问，请在 GitHub 存储库上提交问题。