Calendar MCP Server

基本能力

产品定位

GongRzhe_Calendar-MCP-Server 是一个用于 Google Calendar 集成的 MCP 服务器，旨在通过自然语言交互帮助用户管理日历事件。

核心功能

• 创建日历事件（包括标题、时间、描述和位置）
• 通过事件 ID 检索事件详情
• 更新现有事件（标题、时间、描述、位置）
• 删除事件
• 列出指定时间范围内的事件
• 完全集成 Google Calendar API
• 安全的 OAuth2 认证

适用场景

• 通过 AI 助手管理个人或团队日程
• 自动化日历事件创建和更新
• 批量查询和修改日历事件

工具列表

1. Create Event：创建新的日历事件
2. List Events：列出指定时间范围内的事件
3. Update Event：更新现有事件
4. Delete Event：删除指定事件

常见问题解答

• 安全问题：
• 保持 Google API 凭证安全
• 定期轮换刷新令牌
• 不要将凭证提交到版本控制系统
• 刷新令牌相当于密码，需妥善保管

使用教程

使用依赖

需要安装 Node.js 和 npm。

安装教程

通过 Smithery 安装

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

手动安装

npm install @gongrzhe/server-calendar-mcp

调试方式

1. 确保已正确配置 Google Cloud Project 和 OAuth 2.0 凭证
2. 在 Claude Desktop 中正确配置环境变量
3. 使用提供的 JSON 示例测试各功能

示例配置：

{
  "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"
    }
  }
}

许可证

该项目遵循 ISC 开源许可条款。