Google Calendar MCP 服务器

一个强大的模型上下文协议 (MCP) 服务器，它与 Google 日历集成，提供智能的、上下文感知的日历管理功能。

功能

• 智能日历管理

  • 列出并查看包含详细信息的即将发生的事件
  • 创建具有自定义标题、地点和参与者的新事件
  • 使用新信息更新现有事件
  • 从您的日历中删除事件
  • 支持多个日历

• 上下文感知操作

  • 维护日历操作之间的上下文
  • 智能事件格式化和显示
  • 安全的身份验证和令牌管理
  • 强大的错误处理和验证

前提条件

• Node.js (v16 或更高版本)
• Google Cloud Platform 帐户
• 启用 Google Calendar API
• 来自 Google Cloud Console 的 OAuth 2.0 凭据

设置

1. 克隆存储库：

   git clone https://github.com/yourusername/google-calendar-mcp.git
   cd google-calendar-mcp
   

2. 安装依赖项：

   npm install
   

3. 创建一个 .env 文件：

   cp .env.example .env
   

4. 使用您的 Google Calendar API 凭据更新 .env 文件：

   • GOOGLE_CLIENT_ID: 您的 Google Cloud Console 客户端 ID
   • GOOGLE_CLIENT_SECRET: 您的 Google Cloud Console 客户端密钥
   • GOOGLE_REDIRECT_URI: 您配置的重定向 URI

5. 构建项目：

   npm run build
   

6. 启动服务器：

   npm start
   

使用示例

MCP 服务器通过自然语言命令支持各种日历操作：

事件列表

• "Show me my next 5 upcoming events" (显示我接下来 5 个即将发生的事件)
• "List all events for next week" (列出下周的所有事件)
• "What's on my calendar for tomorrow?" (我明天日历上有什么？)

事件创建

• "Schedule a meeting with John and Sarah tomorrow at 2pm" (安排明天下午 2 点与 John 和 Sarah 的会议)
• "Create a lunch event with the team next Friday at 12pm" (下周五中午 12 点与团队创建一个午餐活动)
• "Add a doctor's appointment for next Monday at 10am" (下周一上午 10 点添加一个医生预约)

事件更新

• "Move my 2pm meeting to 3pm" (将我下午 2 点的会议移到下午 3 点)
• "Add Mike to tomorrow's team meeting" (将 Mike 添加到明天的团队会议)
• "Update the location of Friday's meeting" (更新星期五会议的地点)

事件删除

• "Cancel my 3pm meeting today" (取消我今天下午 3 点的会议)
• "Remove the team lunch from next Friday" (从下周五删除团队午餐)

安全

• 所有凭据和令牌都安全存储，并且不会提交到版本控制
• OAuth 2.0 身份验证确保对 Google 日历的安全访问
• 环境变量用于敏感配置

贡献

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