MCP Server Google Calendar

🚀 基於MCP協議的Google日曆服務器

這是一個基於Model Context Protocol（MCP）協議的Google Calendar集成服務器，支持像Claude Desktop這樣的MCP客戶端向Google Calendar添加日程安排，為用戶提供便捷的日程管理體驗。

🚀 快速開始

此服務器可助力MCP客戶端與Google Calendar實現交互，為日程管理帶來便利。下面為你介紹使用前的準備步驟。

✨ 主要特性

• 🔐 Google OAuth 2.0認證：保障用戶賬戶安全。
• 📅 Google Calendar日程創建：方便用戶添加日程。
• 🔍 支持按時間段查詢Google Calendar日程：便於用戶快速查找日程。
• 📆 獲取當前日期：提供即時日期信息。
• ⏰ 支持韓國時區（KST）：滿足特定時區用戶需求。
• 🛠️ 詳細的錯誤處理和日誌記錄：便於問題排查和系統維護。

📦 安裝指南

克隆倉庫

git clone [倉庫地址]
cd mcp-server-google-calendar

安裝依賴項

npm install

設置環境變量

創建.env文件，並添加以下內容：

GOOGLE_CLIENT_ID=你的客戶ID
GOOGLE_CLIENT_SECRET=你的客戶秘密

📚 詳細文檔

Google Cloud Console設置

1. 訪問Google Cloud Console創建新項目。
2. 啟用Google Calendar API。
3. 創建OAuth 2.0客戶端ID：
   • 應用類型：選擇"桌面應用"
   • 將生成的客戶端ID和秘密添加到.env文件中。

Claude Desktop配置

1. 安裝Claude Desktop
   • Claude Desktop下載
   • MCP功能僅在桌面應用程序中可用。
2. 配置MCP服務器 創建或編輯~/Library/Application Support/Claude/claude_desktop_config.json文件，添加以下內容：

   {
     "mcp-server-google-calendar": {
       "command": "/usr/local/bin/node",
       "args": ["/{絕對路徑}/mcp-server-google-calendar/dist/main.js"],
       "env": {
         "GOOGLE_CLIENT_ID": "你的客戶ID",
         "GOOGLE_CLIENT_SECRET": "你的客戶秘密"
       }
     }
   }
   

3. 啟動Claude Desktop後，訪問設置中的"MCP服務"選項卡啟用此新服務。

可用工具

• 📅 日曆管理：創建、讀取、更新和刪除日程安排。
• ⏱️ 時間查詢：獲取當前日期和時間（支持KST）。
• ⏰ 提醒功能：設置和管理提醒事項。
• 🔄 多端同步：確保不同設備之間的日程同步。

調試

1. 開發者工具啟用：

   echo '{"allowDevTools": true}' > ~/Library/Application\ Support/Claude/developer_settings.json
   

2. 在開發者模式下訪問Command-Option-Shift-i打開調試工具。

錯誤處理

服務器在遇到以下情況時會返回適當的錯誤信息：

• 需要Google認證時
• 時間格式錯誤時
• 必需參數缺失時
• Google Calendar API調用失敗時

日誌記錄

服務器使用Pino日誌器記錄以下信息：

• 服務器啟動和關閉
• 工具調用及響應
• 認證流程
• 錯誤和異常情況

開發環境配置

1. TypeScript構建

npm run build

2. 啟動開發模式（自動重啟）

npm run dev

3. 代碼檢查

npm run lint

問題解決

服務器連接問題

• 檢查Claude Desktop日誌
• 確認服務器進程是否運行
• 核對環境變量設置
• 確保使用絕對路徑

認證問題

• 檢查Google Cloud Console中API是否已啟用
• 重新確認客戶端ID和秘密
• 確認OAuth同意屏幕設置

📄 許可證

本項目採用MIT License進行授權。