Google Calendar MCP 服务器工具说明文档

功能概述

本工具为Google Calendar 提供了一个MCP（机器对机器协议）接口。通过该接口，您可以执行以下操作：

1. 创建事件：使用 createEvent 工具在日历中添加新的日程安排。
2. 更新事件：利用 updateEvent 工具修改现有事件的详细信息。
3. 删除事件：通过 deleteEvent 工具移除特定的日程安排。
4. 获取日历列表：使用 getCalendars 工具检索所有可访问的日历。
5. 认证工具：新增 authenticate 工具，支持在不重启Claude的情况下切换不同的Google账户。

使用指南

MCP消息格式

MCP通信采用JSON-RPC协议，具体请求格式如下：

{
  "jsonrpc": "2.0",
  "method": "tool.name",
  "params": {
    "calendarId": "primary", // 日历ID，默认为"primary"
    "event": { ... }, // 具体事件信息
    ...
  },
  "id": 1
}

工具说明

createEvent

• 功能：创建新的日程安排。
• 参数：
  • calendarId（可选）：指定目标日历，默认为 "primary"。
  • event：包含事件详细信息的对象，必须包括 summary, description, start, 和 end 字段。

updateEvent

• 功能：更新现有事件的信息。
• 参数：
  • eventId：需要修改的事件ID。
  • calendarId（可选）：目标日历，默认为 "primary"。
  • event：包含要更新字段的对象，未提供的字段将保持原值。

deleteEvent

• 功能：删除指定的日程安排。
• 参数：
  • eventId：要删除的事件ID。
  • calendarId（可选）：目标日历，默认为 "primary"。

getCalendars

• 功能：获取所有可访问的日历列表。
• 返回值：包含日历ID和名称的对象数组。

版本历史记录

版本 1.0.6 更新内容

• 删除了不必要的授权范围 (scope) 设置，优化了与Google Calendar API的集成。

版本 1.0.5 更新内容

• 新增功能：
  • 支持通过 recurrence 参数在 createEvent 和 updateEvent 中直接创建和修改重复事件。
  • 允许用户无需手动设置即可管理重复日程安排。

版本 1.0.4 更新内容

• 维护版本更新，与最新依赖保持兼容性。
• 没有功能性变化，主要优化内部代码结构。

版本 1.0.3 更新内容

• 新增功能：

  • 引入 authenticate 工具，支持在运行时重新认证。
  • 实现了账户切换功能，无需重启Claude即可更改Google账户。
  • 提供手动认证选项，适用于无法访问localhost的环境。
  • 增加控制台界面，便于用户输入授权码。

• 优化改进：

  • 更新zod依赖至最新版本（3.24.2）。
  • 修复了多个潜在的安全性和性能问题。

版本 1.0.2 更新内容

• 修复了一个可能导致日历访问权限错误的bug。

贡献指南

• 代码仓库：项目托管在GitHub。
• 提交问题：使用Github Issues报告问题或提出建议。
• 参与开发：欢迎 Fork 仓库并 Pull Request。

测试指南

• 测试要求：

  • 确保拥有有效的Google Calendar账户。
  • 配置正确的API密钥和授权权限。

• 测试方法：

  npm test
  

许可证

本项目遵循MIT License协议，源代码可在Github获取。

如有任何问题，请联系支持团队或访问我们的官方文档。