Gmail MCP サーバー

MCP（Message Control Protocol）フレームワークを使用して構築された、強力で柔軟なGmail統合サーバーです。このサーバーは、Gmail APIと連携するための堅牢なインターフェースを提供し、プログラムによるメールの読み取り、送信、管理機能を提供します。

特徴

• 複数のGmailアカウントからメールを読む

• 添付ファイル付きのメールを送信する

• 高度なクエリオプションでメールを検索する

• メールの添付ファイルをダウンロードする

• メールの会話やスレッドを処理する

• リアルタイムのメール監視

• 複数のGmailアカウントのサポート

Related MCP server: Systemprompt MCP Gmail Server

前提条件

Gmail MCP サーバーを実行する前に、次のものを用意してください。

1. Python 3.12以上

2. Gmail API が有効になっている Google Cloud プロジェクト

3. OAuth 2.0 クライアントID認証情報

4. 必要な Python パッケージ (pyproject.toml で指定)

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の Gmail 統合サーバーを自動的にインストールするには:

1. リポジトリをクローンします。

2. 仮想環境を作成してアクティブ化します。

3. 依存関係をインストールします:

Google Cloud プロジェクトの設定

1. Google Cloud Consoleにアクセスします

2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択してください

3. プロジェクトで Gmail API を有効にする

4. OAuth 2.0 認証情報を作成します。

   • 「APIとサービス」>「認証情報」に移動します

   • 「認証情報を作成」>「OAuthクライアントID」をクリックします

   • アプリケーションの種類として「デスクトップアプリ」を選択します

   • クライアント構成ファイルをダウンロードする

5. ダウンロードしたファイルの名前をclient_secret.jsonに変更し、プロジェクトのルートディレクトリに配置します。

構成

1. gmail_token_creator.pyでメール識別子を設定します。

2. トークン クリエーターを実行して Gmail アカウントを認証します。

3. 統合したいGmailアカウントごとにこのプロセスを繰り返します

サーバー構造

• gmail_server.py : メイン MCP サーバーの実装

• gmail_api.py : Gmail API のインタラクション関数

• google_apis.py : Google API 認証ユーティリティ

• サポートファイル:

  • read_emails.py : メール読み取り機能

  • search_emails.py : メール検索機能

  • send_emails.py : メール送信機能

使用法

サーバーの起動

利用可能なツール

1. メールを送信:

2. メールを検索:

3. 最新のメールを読む:

4. 添付ファイルをダウンロード:

セキュリティに関する考慮事項

• client_secret.jsonを安全に保存し、バージョン管理にコミットしないでください。

• トークンファイルを安全に保ち、 .gitignoreに追加します。

• 機密情報には環境変数を使用する

• OAuth認証情報を定期的にローテーションする

• APIの使用状況を監視し、適切な割り当てを設定する

エラー処理

サーバーには包括的なエラー処理とログ記録が含まれています。

• ログはgmail_mcp.logに書き込まれます

• ファイルとコンソールの両方のログが有効になっています

• デバッグのための詳細なエラーメッセージ

貢献

1. リポジトリをフォークする

2. 機能ブランチを作成する

3. 変更をコミットする

4. ブランチにプッシュする

5. プルリクエストを作成する

ライセンス

Apacheライセンス2.0

サポート

問題や機能のリクエストについては、GitHub の問題追跡ツールを使用してください。