Google Calendar MCP 服务器

一个模型上下文协议 (MCP) 服务器，提供与 Google Calendar API 交互的工具。 此服务器使您能够通过 MCP 接口以编程方式管理您的日历事件。

功能

日历工具

• list_events: 列出即将到来的日历事件，并支持按日期范围过滤
• create_event: 创建包含参与者的新日历事件
• update_event: 更新现有日历事件
• delete_event: 删除日历事件

前提条件

1. Node.js: 安装 Node.js 14 或更高版本
2. Google Cloud Console 设置:
   • 前往 Google Cloud Console
   • 创建一个新项目或选择一个现有项目
   • 启用 Google Calendar API:
     1. 前往 "API 和服务" > "库"
     2. 搜索并启用 "Google Calendar API"
   • 设置 OAuth 2.0 凭据:
     1. 前往 "API 和服务" > "凭据"
     2. 点击 "创建凭据" > "OAuth 客户端 ID"
     3. 选择 "Web 应用程序"
     4. 将 "已授权的重定向 URI" 设置为包含: http://localhost:3000/code
     5. 记下客户端 ID 和客户端密钥

设置说明

1. 克隆和安装:

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

2. 创建 OAuth 凭据: 在根目录中创建一个 credentials.json 文件:

   {
       "web": {
           "client_id": "YOUR_CLIENT_ID",
           "client_secret": "YOUR_CLIENT_SECRET",
           "redirect_uris": ["http://localhost:3000/code"],
           "auth_uri": "https://accounts.google.com/o/oauth2/auth",
           "token_uri": "https://oauth2.googleapis.com/token"
       }
   }
   

3. 获取刷新令牌:

   node get-refresh-token.js
   

   这将:

   • 打开您的浏览器进行 Google OAuth 身份验证
   • 请求以下权限:
     • https://www.googleapis.com/auth/calendar
   • 将凭据保存到 token.json
   • 在控制台中显示刷新令牌

4. 配置 MCP 设置: 将服务器配置添加到您的 MCP 设置文件:

   • 对于 VSCode Claude 扩展: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   • 对于 Claude 桌面应用程序: ~/Library/Application Support/Claude/claude_desktop_config.json

   将以下内容添加到 mcpServers 对象:

   {
     "mcpServers": {
       "google-calendar": {
         "command": "node",
         "args": ["/path/to/google-calendar-server/build/index.js"],
         "env": {
           "GOOGLE_ACCESS_TOKEN": "your_access_token",
         }
       }
     }
   }
   

5. 构建和运行:

   npm run build
   

使用示例

日历操作

1. 列出事件:

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

2. 创建事件:

   {
     "summary": "团队会议",
     "location": "会议室",
     "description": "每周同步",
     "start": "2024-01-24T10:00:00Z",
     "end": "2024-01-24T11:00:00Z",
     "attendees": ["colleague@example.com"]
   }
   

3. 更新事件:

   {
     "eventId": "event_id",
     "summary": "已更新的会议",
     "location": "虚拟",
     "description": "重新安排的每周同步",
     "start": "2024-01-25T10:00:00Z",
     "end": "2024-01-25T11:00:00Z"
   }
   

4. 删除事件:

   {
     "eventId": "event_id"
   }
   

许可证

MIT