強化された Gmail MCP サーバー

Pythonで書かれた、Gmail連携のための強力で機能豊富なモデルコンテキストプロトコル（MCP）サーバーです。このサーバーにより、ClaudeのようなAIアシスタントが自然言語でGmailとやり取りできるようになり、包括的なメール管理機能を提供します。

🌟 主な特徴

📧 完全なメール管理

• 件名、内容、受信者をカスタマイズしてメールを送信します

• 完全なメタデータを含むメールの内容を読み取り、取得します

• 確認してメールをゴミ箱に移動する

• メールを既読/未読としてマークする

• ブラウザで直接メールを開く

📝 ドラフト管理

• 後で確認できるようにメールの下書きを作成する

• すべての下書きメールを一覧表示する

• 既存の下書きを編集する

🏷️ 高度なラベル管理

• 利用可能なすべてのラベルを一覧表示する

• カスタムラベルを作成する

• メールにラベルを適用/削除する

• 既存のラベルの名前を変更する

• 未使用のラベルを削除する

• ラベルでメールを検索する

📁 フォルダの整理

• 新しいフォルダを作成する（Gmail ラベルとして実装）

• フォルダ間でメールを移動する

• 利用可能なすべてのフォルダを一覧表示する

🔍 強力な検索とフィルタリング

• Gmail の高度なクエリ構文を使用してメールを検索する

• メールフィルターの作成、管理、削除

• 送信者、受信者、件名、コンテンツなどでフィルタリング

• 柔軟なパラメータで検索結果をカスタマイズ

🗄️ アーカイブ管理

• メールをアーカイブする（削除せずに受信トレイから削除）

• 検索条件に一致する複数のメールを一括アーカイブ

• アーカイブされたメールをすべて一覧表示する

• アーカイブされたメールを受信トレイに復元する

Related MCP server: GCP MCP

🚀 はじめに

前提条件

• Python 3.8以上

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

• OAuth 2.0 認証情報

インストール

Google Cloud のセットアップ

1. 新しい Google Cloud プロジェクトを作成する

2. Gmail APIを有効にする

3. OAuth 同意画面を設定します。

   • 「外部」ユーザータイプを選択

   • テストユーザーとしてメールアドレスを追加する

   • スコープを追加します: https://www.googleapis.com/auth/gmail/modify

4. OAuth 2.0 認証情報を作成する:

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

   • JSON認証情報ファイルをダウンロードする

構成

資格情報を安全に保存し、サーバーを実行するときにその場所を指定します。

🔧 使用方法

Claude Desktopで実行

Claude Desktop 構成ファイル (通常は~/Library/Application Support/Claude/claude_desktop_config.json ) に次のコードを追加します。

MCP Inspectorによるテスト

テストとデバッグには、MCP インスペクターを使用します。

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

• 資格情報やトークンファイルをバージョン管理にコミットしないでください

• 適切な権限を持つ安全な場所に資格情報を保存する

• サーバーは機密性の高いアクションを実行する前にユーザーの確認を求めます

• Google Cloud Console で異常なアクティビティがないか定期的に確認する

• 機密パスには環境変数の使用を検討する

🛠️ 建築

この実装は、Google API クライアントライブラリを通じてすべての Gmail 操作を処理する包括的な単一ファイルアーキテクチャを備えています。主なコンポーネントは次のとおりです。

• 自動トークン更新機能を備えたOAuth2認証

• 包括的なエラー処理とログ記録

• 明確な入力スキーマを備えた構造化されたツール定義

• 効率的なメール解析とフォーマット

📚 プロンプトの例

Gmail MCP サーバーに接続した後、Claude で次のプロンプトを試してください。

• 「未読メールを見せて」

• 「 example@domain.comからの添付ファイル付きメールを検索する」

• 「「重要なプロジェクト」という新しいラベルを作成します」

• 「今後の会議に関するメールをjohn@example.com宛てに作成する」

• 「 newsletter@example.comからのすべてのメールをアーカイブする」

• 「チームからのメールに自動的にラベルを付けるフィルターを作成する」

🤝 貢献する

貢献を歓迎します！お気軽にプルリクエストを送信してください。

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

2. 機能ブランチを作成します（ git checkout -b feature/amazing-feature ）

3. 変更をコミットします ( git commit -m 'Add some amazing feature' )

4. ブランチにプッシュする ( git push origin feature/amazing-feature )

5. プルリクエストを開く

📄 ライセンス

このプロジェクトは GPL-3.0 ライセンスの下でライセンスされています - 詳細については LICENSE ファイルを参照してください。

🙏 謝辞

• コミュニティ内のさまざまなMCPサーバー実装に触発されて

• モデルコンテキストプロトコルフレームワークで構築

• Googleの公式APIクライアントライブラリを使用