Gcal MCP Server

🚀 Google Calendar MCP 服務器

這是一個基於Model Context Protocol (MCP) 的服務器，藉助標準化接口實現與Google Calendar的集成。它為LLM應用程序提供了管理日曆事件的能力，方便用戶進行各類日曆操作。

🚀 快速開始

在使用本服務器前，你需要完成Google Cloud的相關設置，並進行服務器的安裝。具體步驟如下：

✨ 主要特性

• 列出可用日曆
• 從日曆中列出事件
• 創建新的日曆事件
• 更新現有事件
• 刪除事件

📦 安裝指南

步驟

1. 克隆倉庫：

git clone <repository-url>
cd gcal-mcp-server

2. 創建虛擬環境：

uv venv
# 在 Mac/Linux 上
source .venv/bin/activate
# 在 Windows 上
.venv\Scripts\activate
# 以編輯模式安裝包
uv pip install -e .

📚 詳細文檔

Google Cloud 設置

1. 訪問 Google Cloud Console
2. 創建新項目或選擇現有項目。
3. 啟用 Google Calendar API。
4. 創建OAuth 2.0憑證：
   • 轉到 憑證
   • 點擊 "創建憑證" > "OAuth 客戶端 ID"
   • 選擇 "用戶數據" 作為應用程序將訪問的數據類型。
   • 添加您的應用名稱和聯繫信息。
   • 添加以下範圍（可選）：
     • https://www.googleapis.com/auth/calendar.events
   • 選擇 "桌面應用" 作為應用類型。
   • 在 OAuth 同意屏幕 下添加您的電子郵件地址作為測試用戶。
     • 注意： 測試用戶的傳播可能需要幾分鐘。

💻 使用示例

基礎用法

運行服務器

# 設置所需的 `.env` 文件環境變量。
# 運行服務器
uv run client.py