AI导哈

日历API服务器

Google Calendar API操作服务器，提供日历和事件管理功能，适用于个人和企业日程管理。

  • by CHIHI913
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 CHIHI913/google-calendar-mcp

使用说明

谷歌日历MCP服务器

这是一台操作谷歌Calendar API的MCP（Model Context Protocol）服务器。

机能

日历操作

  • list_calendars -获取日历列表
  • get_calendar -获取日历详细信息

事件操作

  • list_events -获取事件列表
  • get_event -获取事件详细信息
  • search_events -查找事件
  • create_event -创建事件（支持定期事件）
  • update_event -更新事件
  • delete_event -删除事件

定期事件操作

  • update_recurring_event -更新定期事件
    • thisEventOnly：仅此计划
    • all：所有计划
    • thisAndFollowing：以后的计划
  • delete_recurring_instance -删除定期事件的特定实例

实用程序

  • get_freebusy -获取空闲时间信息
  • list_colors -获取可用调色板

安装，安装

1.Google Cloud Console准备

  1. 谷歌云控制台在中创建项目
  2. 启用谷歌日历API
  3. 创建Auth2.0客户端ID
    • 应用程序类型： 网络应用程序
    • 已批准的重定向URI: http://localhost:8080/callback
  4. 下载凭据JSON文件

2.设置环境变量

export CLIENT_SECRET_PATH="/path/to/client_secret.json"
export TOKEN_PATH="/path/to/token.json"

3.安装和构建

pnpm install
pnpm build

4.初回认证

启动服务器后，第一次会在浏览器中请求谷歌认证。身份验证后，将保存该令牌，然后自动进行身份验证。

使用方法

在Claude Desktop中设置

claude_desktop_config.json添加：

{
  "mcpServers": {
    "google-calendar": {
      "command": "node",
      "args": ["/path/to/google-calendar-mcp/dist/index.js"],
      "env": {
        "CLIENT_SECRET_PATH": "/path/to/client_secret.json",
        "TOKEN_PATH": "/path/to/token.json"
      }
    }
  }
}

在Claude Code中设置

claude mcp add google-calendar node /path/to/google-calendar-mcp/dist/index.js \
  -e CLIENT_SECRET_PATH=/path/to/client_secret.json \
  -e TOKEN_PATH=/path/to/token.json

使用例

获取事件列表

今日の予定を教えて

创建事件

明日の14時から15時に「打ち合わせ」という予定を作成して

创建定期事件

毎週月曜日の10時から11時に「週次ミーティング」を10回作成して

单独编辑定期事件

今週の週次ミーティングだけ時間を11時からに変更して

技术栈

  • TypeScript
  • Node.js>=18.0.0
  • @模型上下文协议/sdk
  • 谷歌蜜蜂
  • 黄道带

许可证

麻省理工学院

相关 MCP