CalendarMCP

CalendarMCP

托管式 Google Calendar MCP 服务。 只需约两分钟，即可将任意 AI Agent 连接到你的 Google Calendar。无需自托管、无需 Docker，也无需 credentials.json。

这是什么

CalendarMCP 是面向 Google Calendar 的托管式 Model Context Protocol（MCP）服务。只需连接一次 Google 账号并获取 API 密钥，任何兼容 MCP 的客户端（Claude Desktop、Claude Code、Claude.ai、Cursor、OpenClaw、Continue、Cline、Windsurf、Goose、Zed、ChatGPT 自定义 GPT、n8n 等）都可以读取和写入你的日历。

本仓库提供该服务的公开文档、清单和客户端示例。托管服务并非开源。 如果你需要可自托管的替代方案，最受欢迎的 OSS 选项是 nspady/google-calendar-mcp，我们推荐给希望 OAuth 令牌永远不离开本机的用户。

CalendarMCP 提供了自托管 MCP 不具备的功能

• 零配置。 点击一次 Google OAuth 即可。无需 credentials.json、无需 Google Cloud Console，也无需 Docker。
• HTTP 传输。 兼容 Claude.ai、Claude Code、Cursor 及任何托管式 MCP 客户端。自托管的 stdio MCP 只能用于 Claude Desktop。
• 批量操作。 batch_update_events 可通过一次并发调用更新最多 50 个日历事件。要修改一年内重复会议的名称，只需输入一条提示词，无需点击 50 次。
• 一个密钥管理多个账号。 可在一个 API 密钥下连接任意数量的 Google 账号（混合使用 OAuth 和通过服务账号共享的日历）。读取操作会遍历所有账号，并合并、排序结果。
• 支持 Google Advanced Protection。 唯一可供 GAP 用户使用的托管式 MCP（通过服务账号共享；这些账号无法使用 OAuth）。
• 按日历设置读写权限。 无需创建新密钥，即可在控制面板中收紧每个 Agent 可操作的范围。

快速开始

1. 访问 calendarmcp.ai，使用 Google 登录，然后复制你的 API 密钥。
2. 将 MCP 服务添加到你选择的客户端。配置如下。
3. 与你的 Agent 对话：“我周二有什么安排？”

客户端配置

将以下内容放入 MCP 客户端对应的配置文件中。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "calendar": {
      "command": "npx",
      "args": [
        "@modelcontextprotocol/server-fetch",
        "https://calendarmcp.ai/api/mcp"
      ],
      "env": {
        "MCP_AUTH_HEADER": "Authorization: Bearer YOUR_CALENDARMCP_API_KEY"
      }
    }
  }
}

参见 examples/claude-desktop.json 和我们的 Claude Desktop 集成指南。

Claude Code

claude mcp add calendar https://calendarmcp.ai/api/mcp \
  --transport http \
  --header "Authorization: Bearer YOUR_CALENDARMCP_API_KEY"

参见 examples/claude-code.sh 和我们的 Claude Code 集成指南。

Cursor

~/.cursor/mcp.json：

{
  "mcpServers": {
    "calendar": {
      "url": "https://calendarmcp.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_CALENDARMCP_API_KEY"
      }
    }
  }
}

参见 examples/cursor.json 和我们的 Cursor 集成指南。

OpenClaw

在你的 openclaw.json 中：

{
  "plugins": {
    "entries": {
      "mcp-calendarmcp": {
        "enabled": true,
        "config": {
          "url": "https://calendarmcp.ai/api/mcp",
          "authHeader": "Bearer YOUR_CALENDARMCP_API_KEY"
        }
      }
    }
  }
}

参见 examples/openclaw.json 和我们的 OpenClaw 集成指南。

其他客户端

参见 examples/，其中包含 Continue、Windsurf、Goose、n8n 等客户端的示例。

工具

CalendarMCP 提供 11 个工具。完整的机器可读架构位于 https://calendarmcp.ai/api/docs。

工具	描述
list_events	列出指定时间范围内一个或所有已连接日历中的事件。自动分页，最多返回 2500 条结果。
get_event	获取单个事件的完整详情。
create_event	创建事件。支持与会者、地点、提醒、重复规则和全天事件。
update_event	对现有事件进行部分更新。
delete_event	删除事件。
quick_add_event	根据自然语言创建事件（“周五下午 1 点和 Sam 共进午餐”）。
list_calendars	列出 API 密钥可访问的所有日历，并显示每个日历的读/写权限。
find_free_time	查询一个或多个日历的空闲/忙碌情况。创建事件前应调用此工具，以避免重复预订。
manage_attendees	为事件添加或移除与会者。
batch_update_events	在一次并发调用中更新最多 50 个事件。

完整参考：docs/tools.md。

身份验证

API 密钥可在控制面板 calendarmcp.ai/dashboard 中获取。一个密钥可以关联任意数量的 Google 账号。每个日历的读/写权限范围由服务端强制执行。

速率限制：每个密钥每分钟 60 次请求。 提供免费套餐；更高限额的按使用量付费方案即将推出。

请参阅 docs/authentication.md。

Google Advanced Protection

如果你启用了 Google Advanced Protection，根据 Google 政策，OAuth 无法连接第三方日历应用。CalendarMCP 支持一种适用于 GAP 用户的服务账号共享流程。据我们所知，我们是唯一支持此功能的托管 MCP 服务。

请参阅 docs/google-advanced-protection.md。

路线图

• ✅ Google Calendar（已上线）
• ⏳ Microsoft Outlook Calendar（候补名单）
• ⏳ iCloud Calendar（候补名单）
• ⏳ CalDAV（任意提供商）

定价

提供额度充足的免费套餐。面向高级用户的付费方案即将推出。

请参阅 calendarmcp.ai/pricing。

对比

功能	CalendarMCP	nspady (OSS)	Composio	Zapier MCP
托管	✅	❌	✅	✅
HTTP 传输	✅	❌（仅 stdio）	✅	✅
设置时间	2 分钟	25 分钟	10 分钟	5 分钟
批量更新事件	✅	❌	❌	❌
多账号共用一个密钥	✅	❌	❌	❌
Google Advanced Protection	✅	❌	❌	❌
按日历划分的读/写权限矩阵	✅	❌	❌	❌
开源	❌	✅	部分开源	❌
令牌存储在你的设备上	❌	✅	❌	❌

坦诚地说：如果你只使用 Claude Desktop，且不想经过任何第三方，请选择 nspady。其他情况请选择 CalendarMCP。

参与贡献

本仓库包含文档和示例。欢迎提交 PR，内容包括：

• 新的客户端配置示例
• 改进文档并补充说明
• 翻译

服务问题（托管产品的错误、功能请求）→ GitHub Issues。

许可证

本仓库中的示例和文档：MIT（参见 LICENSE）。

托管服务不开源。

链接

• calendarmcp.ai。服务
• 文档
• 博客
• 更新日志
• 集成
• 使用场景