Google Calendar MCP Server

Google Calendar MCP 服务

一个提供 Google Calendar 数据访问能力的模型上下文协议（MCP）服务。

功能

• 列出可用的 Google Calendar
• 查找日历中的可用时段
• 获取日历中的近期活动

前提条件

• Python 3.9+
• 已启用 Calendar API 的 Google Cloud 项目
• OAuth2 凭据

设置

1. 安装依赖项：

   pip install -r requirements.txt
   

2. 设置 Google Calendar API 凭据：

   python setup_credentials.py
   

   按照提示使用 Google 进行身份验证。

3. 运行服务：

   python google_calendar_server.py
   

与 Claude Desktop 配合使用

编辑配置文件，将此服务配置为 Claude Desktop 的服务：

{
  "mcpServers": {
    "google-calendar": {
      "command": "python",
      "args": ["/full/path/to/google_calendar_server.py"],
      "env": {
        "GOOGLE_TOKEN_FILE": "/path/to/token/file.json"
      }
    }
  }
}

可用工具

list_calendars

列出所有可用的 Google Calendar。

get_available_slots

查找日历中的可用时段。

参数：

• calendar_id：要检查的日历 ID
• days_ahead：要向前检查的天数（默认值：7）
• slot_duration_minutes：每个时段的时长（分钟）（默认值：30）
• start_hour：一天中的开始时间，采用 24 小时制（默认值：9）
• end_hour：一天中的结束时间，采用 24 小时制（默认值：17）

get_upcoming_events

获取日历中的近期活动。

参数：

• calendar_id：要检查的日历 ID
• days_ahead：要向前检查的天数（默认值：7）
• max_events：要返回的活动数量上限（默认值：10）