Google Toolbox

🚀 py-mcp-google

py-mcp-google は MCP サーバーツールで、Google Workspace（Gmail、Google Calendar、Google Drive を含む）とのインタラクション用のインターフェースを提供します。

🚀 クイックスタート

py-mcp-google を使用することで、Google Workspace の様々なサービスと簡単にやり取りできます。以下に、インストール方法や使用方法を説明します。

✨ 主な機能

• Gmail、Google Calendar、Google 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

📚 ドキュメント

環境変数

以下の環境変数を設定することで、動作をカスタマイズできます。

• GOOGLE_CREDENTIALS: Google API の認証情報ファイルのパス
• DEFAULT_EMAIL: デフォルトのメールアドレス

使用方法

サーバーを起動した後、http://localhost:8000 にアクセスすることで、Web インターフェースを使用できます。

ツールドキュメント

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 検索を実行し、整形された結果を返す。

💻 使用例

基本的な使用法

# メールをリストする
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"

設定例

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 ライセンスの下で公開されています。