🚀 Google Calendar MCP 服務器
Google Calendar MCP 服務器是一個用於 Google 日曆集成的 Claude Desktop 模型上下文協議(MCP)服務器。藉助該服務器,AI 助手能夠通過自然語言交互來管理 Google 日曆事件,為用戶提供便捷的日曆管理體驗。

🚀 快速開始
本服務器允許 AI 助手通過自然語言交互管理 Google 日曆事件,你可以按照以下步驟進行安裝和設置。
✨ 主要特性
- 創建日曆事件:可創建帶有標題、時間、描述和位置的日曆事件。
- 檢索事件信息:通過事件 ID 檢索事件詳細信息。
- 更新事件內容:能夠更新現有事件的標題、時間、描述和位置。
- 刪除事件操作:支持刪除指定事件。
- 列出指定時段事件:可在指定時間段內列出事件。
- 集成 Google 日曆 API:與 Google 日曆 API 完全集成。
- 安全認證機制:採用安全的 OAuth2 身份驗證。
📦 安裝指南
通過 Smithery 安裝
要通過 Smithery 自動安裝 Claude Desktop 的 Google 日曆集成,可使用以下命令:
npx -y @smithery/cli install @gongrzhe/server-calendar-mcp --client claude
手動安裝
使用以下命令進行手動安裝:
npm install @gongrzhe/server-calendar-mcp
📚 詳細文檔
設置步驟
- 創建 Google Cloud 項目並獲取憑證:
- 創建 Google Cloud 項目:
- 創建 OAuth 2.0 憑證:
- 轉到“APIs & Services” > “Credentials”。
- 點擊“創建憑據” > “OAuth 客戶端 ID”。
- 選擇“桌面應用”作為應用程序類型。
- 輸入名稱並點擊“創建”。
- 獲取您的
GOOGLE_CLIENT_ID
和 GOOGLE_CLIENT_SECRET
。
- 獲取刷新令牌:
- 訪問 OAuth 2.0 Playground。
- 點擊右上角的齒輪圖標(設置)。
- 啟用“使用自己的 OAuth 憑證”。
- 輸入您的 OAuth 客戶端 ID 和客戶端密鑰。
- 在左側面板中找到“Calendar API v3”並選擇 "https://www.googleapis.com/auth/calendar"。
- 點擊“授權 API”並完成 OAuth 流程。
- 點擊“交換授權代碼以獲取令牌”。
- 複製“刷新令牌”,這就是您的
GOOGLE_REFRESH_TOKEN
。
- 在 Claude Desktop 中配置:
{
"calendar": {
"command": "npx",
"args": [
"@gongrzhe/server-calendar-mcp"
],
"env": {
"GOOGLE_CLIENT_ID": "your_client_id_here",
"GOOGLE_CLIENT_SECRET": "your_client_secret_here",
"GOOGLE_REFRESH_TOKEN": "your_refresh_token_here"
}
}
}
💻 使用示例
基礎用法
創建日曆事件
curl -X POST http://localhost:3000/calendars \
-H 'Content-Type: application/json' \
-d '{"name": "My Calendar"}'
curl -X POST http://localhost:3000/calendars/[CALENDAR_ID]/events \
-H 'Content-Type: application/json' \
-d '{"summary": "Meeting", "start": {"dateTime": "2024-01-01T10:00:00"}, "end": {"dateTime": "2024-01-01T11:00:00"}}'
獲取事件
curl http://localhost:3000/calendars
curl http://localhost:3000/calendars/[CALENDAR_ID]/events
⚠️ 重要提示
- 刷新令牌提供對您的 Google 日曆的訪問權限,請妥善保管。
- 不要將憑證提交到版本控制系統。
- 定期更新和管理 API 密鑰以確保安全。
💡 使用建議
歡迎貢獻!請隨意提交 Pull Request。
📄 許可證
本項目使用 ISC 許可證。
👨💻 作者
gongrzhe