AI导哈

日历事件管理服务

一个用于Google Calendar集成的Model Context Protocol (MCP)服务器，支持创建、更新、删除和管理日历事件，包括批量操作和企业级重试机制。

  • by wanthigh
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 wanthigh/google-calendar-mcp-server

使用说明

谷歌日历MCP服务器

用于Google日历与Claude Desktop集成的模型上下文协议（MCP）服务器。使用批处理操作和企业级重试机制创建、更新、删除和管理日历事件。

🚀 快速开始

1.安装

npm install -g github:wanthigh/google-calendar-mcp-server

2.设置Google日历API

  1. 首选 谷歌云控制台
  2. 创建新项目或选择现有项目
  3. 启用Google日历API
  4. 创建凭据：
    • 转到“凭据”→ “创建凭据”→ “OAuth 2.0客户端ID”
    • 选择“桌面应用程序”
    • 下载JSON文件

3.配置

为您的配置文件创建一个文件夹并保存您的凭据：

mkdir ~/.google-calendar-mcp
# Save your downloaded credentials.json to ~/.google-calendar-mcp/credentials.json

4.添加到克劳德桌面或克劳德代码

适用于克劳德桌面

编辑您的Claude Desktop配置文件：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "google-calendar": {
      "command": "google-calendar-mcp",
      "args": ["--credentials", "/Users/YOUR_USERNAME/.google-calendar-mcp/credentials.json"]
    }
  }
}

克劳德代码

编辑您的Claude Code全局配置文件：

所有平台: ~/.claude.json

{
  "mcpServers": {
    "google-calendar": {
      "command": "google-calendar-mcp",
      "args": ["--credentials", "/Users/YOUR_USERNAME/.google-calendar-mcp/credentials.json"]
    }
  }
}

备注：在Windows上，替换 /Users/YOUR_USERNAME/ 随着 C:\Users\YOUR_USERNAME\

5.第一轮

重新启动克劳德桌面。第一次使用日历功能时，系统会提示您通过浏览器授权访问。

备注：如果需要手动授权（罕见），可以运行：

google-calendar-mcp --credentials /Users/YOUR_USERNAME/.google-calendar-mcp/credentials.json

✨ 特性

  • 单一操作：创建、更新、删除、列出和搜索事件
  • 批量操作：高效处理多个事件
  • 智能重试：API故障的指数退避自动重试
  • 速率限制：内置保护，防止配额耗尽
  • 认证：OAuth2和服务帐户支持

🛠️ 可用工具

基本操作

  • create_event -创建新的日历事件
  • update_event -更新现有事件
  • delete_event -删除事件
  • list_events -列出时间范围内的事件
  • search_events -按关键字搜索事件

批量操作

  • batch_create_events -创建多个事件
  • batch_update_events -更新多个事件
  • batch_delete_events -删除多个事件

🔧 Claude中的示例用法

“明天下午2点创建一个名为“团队同步”的会议”

“列出我下周的所有活动”

“删除ID为abc123的事件”

“为下个月每周一上午10点创建5个培训课程”

🐛 故障排除

“身份验证失败”

  • 检查您的credentials.json文件路径
  • 在浏览器中完成OAuth授权

“未找到日历”

  • 确保您使用的日历ID正确
  • 对于服务帐户，请将您的日历与服务帐户电子邮件共享

“超出费率限制”

  • 服务器具有内置的重试机制
  • 如果需要，减少批量大小

📞 支持

📄 许可证

MIT许可证

版本: 1.0.1 | 作者：@wanthigh

相关 MCP