🚀 Google Calendar MCP 服务器

Google Calendar MCP 服务器是一个用于 Google 日历集成的 Claude 桌面 Model Context Protocol (MCP) 服务器。借助该服务器，AI 助手能够通过自然语言交互来管理 Google 日历事件。

🚀 快速开始

本服务器可助力 AI 助手通过自然语言交互管理 Google 日历事件，下面为你介绍其功能、安装、配置及使用方法。

✨ 主要特性

• 创建带有标题、时间、描述和位置的日历事件
• 通过事件 ID 查取详细信息
• 更新现有事件（标题、时间、描述、位置）
• 删除事件
• 在指定时间段内列出事件
• 完全集成 Google 日历 API
• 安全的 OAuth2 认证

📦 安装指南

使用 Smithery 自动安装

通过 Smithery 可自动安装 Google 日历对 Claude 桌面的集成：

npx -y @smithery/cli install @gongrzhe/server-calendar-mcp --client claude

手动安装

npm install @gongrzhe/server-calendar-mcp

📚 详细文档

配置

1. 创建 Google Cloud 项目并获取凭证： a. 创建 Google Cloud 项目：
   • 访问 Google Cloud Console
   • 创建新项目或选择现有项目
   • 启用项目的 Google 日历 API b. 创建 OAuth 2.0 凭证：
   • 转到 "APIs & Services" > "Credentials"
   • 点击 "Create Credentials" > "OAuth client ID"
   • 选择应用类型为 "Desktop app"
   • 输入名称并点击 "Create"
   • 获取客户端 ID 和密钥 c. 使用 OAuth2 获取访问令牌：
   • 访问 Google API Console
   • 创建项目并启用日历 API
   • 添加 OAuth 客户端 ID
   • 生成 OAuth 2.0 令牌
2. 在 Claude 桌面配置中添加以下内容：

{
  "calendar": {
    "enable": true,
    "apiKey": "你的 Google 日历 API 密钥",
    "clientId": "你的客户端 ID",
    "clientSecret": "你的客户端密钥"
  }
}

💻 使用示例

基础用法

创建日历事件

{
  "summary": "会议提醒",
  "start.dateTime": "2024-03-15T10:00:00+08:00",
  "end.dateTime": "2024-03-15T11:00:00+08:00"
}

获取事件列表

{
  "timeMin": "2024-03-15T00:00:00+08:00",
  "maxResults": 10
}

⚠️ 重要提示

⚠️ 重要提示

• 安装完成后重启 Claude 桌面以应用配置
• 确保 API 密钥和客户端凭证安全，避免泄露
• 定期更新访问令牌以增强安全性

🤝 贡献

欢迎贡献！请随时提交 Pull Request。

📄 许可证

本项目 licensed under ISC License。

👨‍💻 作者

gongrzhe