Google Calendar MCP 服务器

一个用于Google日历集成的Claude Desktop模型上下文协议（MCP）服务器。此服务器允许AI助手通过自然语言交互管理Google日历事件。

功能

• 创建带有标题、时间、描述和位置的日历事件
• 通过事件ID检索事件详细信息
• 更新现有事件（标题、时间、描述、位置）
• 删除事件
• 在指定时间段内列出事件
• 完全集成Google日历API
• 安全的OAuth2身份验证

安装

通过Smithery安装

要通过Smithery自动安装Claude Desktop的Google日历集成：

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日历API

   b. 创建OAuth 2.0凭证：

   • 转到“APIs & Services” > “Credentials”
   • 点击“创建凭据” > “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流程
   • 点击“交换授权代码以获取令牌”
   • 复制“刷新令牌”- 这是您的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"
    }
  }
}

使用示例

创建日历事件

# 创建新日历
curl -X POST http://localhost:3000/calendars \
  -H 'Content-Type: application/json' \
  -d '{"name": "My Calendar"}'

# 在指定日历中创建事件
curl -X POST http://localhost:3000/calendars/[CALENDAR_ID]/events \
  -H 'Content-Type: application/json' \
  -d '{"summary": "Meeting", "start": {"dateTime": "2024-01-01T10:00:00"}, "end": {"dateTime": "2024-01-01T11:00:00"}}'

获取事件

# 获取所有日历
curl http://localhost:3000/calendars

# 获取特定日历的事件
curl http://localhost:3000/calendars/[CALENDAR_ID]/events

安全注意事项

• 刷新令牌提供对您的Google日历的访问权限，妥善保管
• 不要将凭证提交到版本控制系统
• 定期更新和管理API密钥以确保安全

贡献指南

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

许可证

本项目使用ISC许可证。

作者

gongrzhe