MCP Gmail

🚀 MCP Gmail サーバー

このサーバーは、Model Context Protocol (MCP) を用いて Gmail へのアクセス権限を提供します。MCP Python SDK でサポートされています。

✨ 主な機能

• Gmail メッセージを MCP リソースとして公開します。
• 新しいメール草稿を作成するための compose_email ツールを提供します。
• メールを送信するための send_email ツールを提供します。
• 送信者、受信者、件名などに基づいてメールを検索する search_emails ツールを提供します。
• 元の Gmail クエリ構文を使用してメールを検索する query_emails ツールを提供します。
• ID で複数のメールメッセージを取得する get_emails ツールを提供します。
• すべての利用可能な Gmail ラベルを取得する list_available_labels ツールを提供します。
• メッセージを既読にする mark_message_read ツールを提供します。
• メッセージにラベルを追加する add_label_to_message ツールを提供します。
• メッセージからラベルを削除する remove_label_from_message ツールを提供します。

📦 インストール

前提条件

• Python 3.10 以上
• API アクセス権限を持つ Gmail アカウント

手順

ステップ 1: 依存関係のインストール

uv コマンドを使用してプロジェクトを同期し、必要なすべての依存関係をインストールします。

uv sync

ステップ 2: OAuth 認証情報の設定

1. Google Cloud Console を開き、新しいプロジェクトを作成します。
2. Gmail API を有効にします。
3. OAuth 画面設定セクションに移動し、アプリ情報とアクセス許可スコープを入力します。
4. OAuth クライアント ID を作成し、credentials.json ファイルをダウンロードします。

ステップ 3: 設定の検証

以下のコマンドを実行して、設定が正しいことを確認します。

python test_script.py

サーバーの起動

• 開発モードでサーバーを起動するには：

uv run server.py

• Claude Desktop にインストールするには： command 属性を正しい uv 実行可能ファイルのパスに設定し、環境変数を credentials.json および token.json ファイルに向けます。

環境変数

プロジェクトは、以下の環境変数で構成できます。

💻 使用例

サーバーが起動したら、以下のリソースとツールを使用してやり取りできます。

利用可能なリソース

• gmail://messages/{message_id}: 単一のメールメッセージにアクセスします。
• gmail://threads/{thread_id}: メールスレッドにアクセスします。

利用可能なツール

• compose_email: 新しいメール草稿を作成します。
• send_email: メールを送信します。
• search_emails: 送信者、受信者、または件名に基づいてメールを検索します。
• query_emails: 元の Gmail クエリ構文を使用してメールを検索します。
• get_emails: ID で複数のメールメッセージを取得します。
• list_available_labels: すべての利用可能な Gmail ラベルを取得します。
• mark_message_read: メッセージを既読にします。
• add_label_to_message: メッセージにラベルを追加します。
• remove_label_from_message: メッセージからラベルを削除します。

📄 ライセンス

MIT