Google Toolbox

🚀 py-mcp-google

py-mcp-google 是一款 MCP 服務器工具，它為用戶與 Google Workspace（涵蓋 Gmail、Google Calendar 和 Google Drive）的交互提供了便捷的接口，讓用戶能更高效地使用 Google 的各項服務。

🚀 快速開始

運行後，你可以通過訪問 http://localhost:8000 使用 Web 界面。

✨ 主要特性

• 為與 Google Workspace（包括 Gmail、Google Calendar 和 Google Drive）交互提供接口。
• 提供多種工具，如 Gmail 工具、日曆工具、Drive 工具和搜索工具，滿足不同的使用需求。

📦 安裝指南

從源碼安裝

1. 克隆倉庫：

git clone git@github.com:jikime/py-mcp-google.git
cd py-mcp-google
pip install .

2. 啟動服務器：

uv run server.py

使用 Docker

docker build -t py-mcp-google .
docker run -it py-mcp-google

💻 使用示例

客戶端示例

# 列出郵件
uv run client.py list_emails max_results=5 query="is:unread"

# 搜索郵件
uv run client.py search_emails query="from:test@example.com"

# 發送郵件
uv run client.py send_email to="test@example.com" subject="測試郵件" body="你好"

# 修改郵件
uv run client.py modify_email id=MESSAGE_ID remove_labels=INBOX add_labels=ARCHIVED

# 列出活動
uv run client.py list_events time_min=2025-05-01T00:00:00+09:00 time_max=2025-05-02T23:59:59+09:00 max_results=5

# 創建活動
uv run client.py create_event summary="新事件" start=2025-05-02T10:00:00+09:00 end=2025-05-02T11:00:00+09:00

# 更新活動
uv run client.py update_event id=event_id summary="更新後的事件" start=2025-05-03T10:00:00+09:00

# 刪除活動
uv run client.py delete_event id=event_id

# 讀取文件
uv run client.py read_gdrive_file id=file_id

# 搜索文件
uv run client.py search_gdrive query="test"

📚 詳細文檔

配置

環境變量

設置以下環境變量以自定義行為：

• GOOGLE_CREDENTIALS: Google API 憑證文件路徑
• DEFAULT_EMAIL: 默認電子郵件地址

工具文檔

Gmail 工具

• list_emails: 列出收件箱中的近期郵件，支持過濾選項。
• search_emails: 執行高級搜索並獲取詳細郵件內容。
• send_email: 編寫併發送郵件，支持 CC 和 BCC 收件人。
• modify_email: 修改郵件狀態（已讀/未讀、存檔、刪除）。

日曆工具

• list_events: 獲取指定時間段內的日曆活動。
• create_event: 創建新事件，支持添加參與者和位置描述。
• update_event: 更新現有事件信息。
• delete_event: 根據活動 ID 刪除事件。

Drive 工具

• read_gdrive_file: 讀取並獲取 Google Drive 文件內容。
• search_gdrive: 搜索文件，支持自定義查詢。

搜索工具

• search_google: 執行 Google 搜索並返回格式化結果。

配置示例

Claude desktop app

在 app.json 中添加：

{
  "py-mcp-google": {
    "url": "http://localhost:8000",
    "email": "你的電子郵件地址"
  }
}

Cursor IDE

在項目根目錄創建 mcp-config.json：

{
  "google": {
    "credentials": "~/.config/google/creds.json",
    "defaultEmail": "你@example.com"
  }
}

📄 許可證

本項目採用 MIT 許可證。