Gongrzhe Calendar Autoauth MCP Server

🚀 Google日曆AutoAuth MCP服務器

這是一個用於將Google Calendar集成到Claude Desktop的Model Context Protocol (MCP) 服務器，支持自動身份驗證。該服務器具備創建、讀取、更新和刪除日曆事件的功能，極大地提升了日曆管理的便捷性。

✨ 主要特性

• 創建事件：支持指定標題、開始時間、結束時間、描述和位置。
• 列出事件：可以根據時間範圍查詢特定時間段內的日曆事件，並支持按開始時間排序。
• 更新事件：允許修改事件的標題、時間和其他屬性。
• 刪除事件：可以指定事件ID進行刪除。

📦 安裝指南

1. 下載服務器

從GitHub倉庫下載MCP服務器：

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

2. 安裝依賴

安裝所需的Python包：

pip install google-auth google-auth-oauthlib googleapis-common-protos google-resumable-media

3. 配置日曆API

在Google Cloud Console中創建項目並啟用日曆API。下載service-account.json文件，並將其置於項目的根目錄。

💻 使用示例

基礎用法

創建事件

{
  "summary": "團隊會議",
  "start": {
    "dateTime": "2024-01-20T10:00:00Z"
  },
  "end": {
    "dateTime": "2024-01-20T11:00:00Z"
  },
  "description": "每週一次的團隊同步",
  "location": "A會議室"
}

列出事件

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

更新事件

{
  "eventId": "event123",
  "summary": "更新後的會議標題",
  "start": {
    "dateTime": "2024-01-20T11:00:00Z"
  },
  "end": {
    "dateTime": "2024-01-20T12:00:00Z"
  }
}

刪除事件

{
  "eventId": "event123"
}

📚 詳細文檔

安全注意事項

⚠️ 重要提示

• OAuth憑證安全：確保service-account.json文件不會被洩露或提交到版本控制系統。
• 權限管理：定期檢查並清理不再使用的API訪問權限。

故障排除

問題1：無法連接到Google Calendar

💡 使用建議

檢查網絡是否正常，確認日曆API已正確啟用，並且服務賬戶有適當的權限。

問題2：時間格式錯誤

💡 使用建議

確保所有時間字段都遵循ISO 8601標準格式（例如："2024-01-20T10:00:00Z"）。

貢獻

歡迎任何貢獻！請通過提交Pull Request的方式參與項目開發。

📄 許可證

本項目採用ISC許可證。

作者

gongrzhe