Google日历MCP服务器文档（中文版）

简介

此项目是一个Google日历MCP（机器可读数据接口）服务器，用于实现Google日历与[假设是Claude Desktop]平台之间的集成。该服务器支持自动认证功能，用户可以通过自然语言指令与Google日历进行交互。

主要功能

• 创建日历事件：支持通过指定时间、地点和描述信息来安排新会议。
• 查询日历事件：可以检索特定时间段内的所有或部分日历条目。
• 更新日历事件：允许修改现有事件的详细信息，如标题、时间和位置。
• 删除日历事件：提供删除指定日历事件的功能。

安装与认证

环境准备

1. 下载并安装Node.js（推荐使用版本16或更高）。
2. 安装npm包管理工具。
3. 克隆此项目仓库到本地开发环境中。

认证步骤

1. 在Google Cloud Console中创建一个新的项目。
2. 启用日历API和OAuth 2.0客户端认证功能。
3. 创建OAuth 2.0客户端ID，并下载gcp-oauth.keys.json配置文件。
4. 将获取到的私钥文件命名为gcp-oauth.keys.json，并放置在项目的根目录下或当前工作目录中。

使用示例

创建日历事件

{
  "summary": "团队会议",
  "start": {
    "dateTime": "2024-01-20T10:00:00Z"
  },
  "end": {
    "dateTime": "2024-01-20T11:00:00Z"
  },
  "description": "每周一次的团队同步会议",
  "location": "A会议室"
}

查询日历事件

{
  "timeMin": "2024-01-01T00:00:00Z",
  "timeMax": "2024-12-31T23:59:59Z",
  "maxResults": 10,
  "orderBy": "startTime"
}

更新日历事件

{
  "eventId": "event123",
  "summary": "更新后的会议主题",
  "start": {
    "dateTime": "2024-01-20T11:00:00Z"
  },
  "end": {
    "dateTime": "2024-01-20T12:00:00Z"
  }
}

删除日历事件

{
  "eventId": "event123"
}

安全须知

• 凭证存储：认证信息将安全地保存在本地环境变量~/.calendar-mcp/中。
• 离线访问模式：服务器使用离线访问令牌以保持持久认证状态。
• 凭证管理：请勿分享或提交到版本控制系统。
• 定期审查：建议定期检查并撤销不再使用的Google账户权限。

故障排查

1. 找不到OAuth密钥文件

   • 确保gcp-oauth.keys.json存在于当前工作目录或~/.calendar-mcp/中
   • 检查文件访问权限设置是否正确

2. 凭证格式无效

   • 确认密钥文件包含有效的web或installed类型配置
   • 如果需要重新生成，可以参考Google Cloud Console的文档说明

3. 端口被占用

   • 检查当前系统进程，确认是否有其他程序占用了目标端口
   • 可以尝试使用不同的端口号运行服务器

贡献与许可

• 项目作者：[假设是Claude Desktop开发团队]
• 许可证类型：ISC许可证
• 任何个人或组织都可以自由使用、修改和分发此软件，但需遵守相关法律条款。

此文档介绍了Google日历MCP服务器的基本功能、安装方法及使用指南。如需进一步支持，请参考相关技术文档或联系项目维护人员。