Gmail MCP

Gmail MCP

Gmail API のモデル コンテキスト プロトコル (MCP)実装。メールの管理、送信、取得のための標準化されたインターフェースを提供します。

特徴

• メッセージ、スレッド、ラベル、下書き、設定を含む Gmail API を完全にカバーします
• メールの送信、下書き、管理のサポート
• カスタマイズ可能な色と表示設定によるラベル管理
• 会話管理のためのスレッド操作
• 不在通知、IMAP/POP、言語設定などの設定管理
• メールボックスの変更履歴の追跡
• Google Cloud 認証情報を使用した安全な OAuth2 認証

前提条件

この MCP サーバーを実行するには、まず組織用に Google API クライアントを設定し、各ユーザーが独自の OAuth リフレッシュ トークンを取得するスクリプトを実行する必要があります。

Google API クライアントのセットアップ（組織ごとに 1 回）

1. Google Cloud Consoleに移動します。
2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択します。
3. プロジェクトで Gmail API を有効にします。
4. 「認証情報」に移動し、OAuth 2.0クライアントIDを作成します。クライアントの種類として「デスクトップアプリ」を選択します。
5. OAuth キー JSON をダウンロードし、 ~/.gmail-mcp/gcp-oauth.keys.jsonとして保存します。
6. (オプション) リモート サーバーのインストール (例: Smithery CLI の使用) の場合は、このファイルのCLIENT_IDとCLIENT_SECRETメモします。

クライアント OAuth (ユーザーごとに 1 回)

1. ユーザーに~/.gmail-mcp/gcp-oauth.keys.jsonを自分のコンピュータの同じパスにコピーしてもらいます。
2. npx @shinzolabs/gmail-mcp authを実行します。
3. ブラウザ ウィンドウが開き、ユーザーはプロファイルを選択し、要求されたスコープを確認して承認できます。
4. （オプション）リモートサーバーへのインストールの場合、成功メッセージに記載されているファイルパス（デフォルトでは~/.gmail-mcp/credentials.json ）をメモしてください。ユーザーのREFRESH_TOKENここにあります。

クライアント構成

MCPクライアントとサーバーの設定にはいくつかのオプションがあります。ホスト型/リモートサーバーの場合は、SmitheryのCLIとSmithery APIキーを使用してください。ローカルインストールの場合は、 npxを使用するか、ソースからビルドしてください。それぞれのオプションについては以下で説明します。

Smithery リモートサーバー (推奨)

MCP クライアントのconfig.jsonにリモート サーバーを追加するには、 Smithery CLIから次のコマンドを実行します。

プロンプトが表示されたら、 CLIENT_ID 、 CLIENT_SECRET 、およびREFRESH_TOKEN入力します。

鍛冶屋SDK

独自のエージェント アプリケーションを開発している場合は、ここにある定型コードを使用できます。

NPX ローカルインストール

npxを使用してサーバーをローカルにインストールするには、MCP クライアントのconfig.jsonに以下を追加します。

ソースからビルド

1. リポジトリをダウンロードしてください:

2. パッケージをインストールし、 pnpmでビルドします (クローンされたリポジトリ内):

3. MCP クライアントのconfig.jsonに次のコードを追加します。

設定変数

サポートされているエンドポイント

ユーザー管理

• get_profile : 現在のユーザーのGmailプロフィールを取得する
• stop_mail_watch : プッシュ通知の受信を停止する
• watch_mailbox : メールボックスの変更に関するプッシュ通知を設定する

メッセージ管理

メッセージの管理

• list_messages : オプションのフィルタリング付きでメッセージを一覧表示する
• get_message : 特定のメッセージを取得する
• get_attachment : メッセージの添付ファイルを取得する
• modify_message : メッセージラベルを変更する
• send_message : 指定された受信者に電子メールメッセージを送信する
• delete_message : メッセージを完全に削除する
• trash_message : メッセージをゴミ箱に移動する
• untrash_message : ゴミ箱からメッセージを削除する
• batch_modify_messages : 複数のメッセージを変更する
• batch_delete_messages : 複数のメッセージを削除する

ラベル管理

• list_labels : すべてのラベルを一覧表示する
• get_label : 特定のラベルを取得する
• create_label : 新しいラベルを作成する
• update_label : ラベルを更新する
• patch_label : ラベルの部分更新
• delete_label : ラベルを削除する

スレッド管理

• list_threads : メールスレッドを一覧表示する
• get_thread : 特定のスレッドを取得する
• modify_thread : スレッドラベルを変更する
• trash_thread : スレッドをゴミ箱に移動する
• untrash_thread : スレッドをゴミ箱から削除する
• delete_thread : スレッドを削除する

ドラフト管理

• list_drafts : ユーザーのメールボックス内の下書きを一覧表示する
• get_draft : IDで特定のドラフトを取得する
• create_draft : Gmailでメールの下書きを作成する
• update_draft : 下書きの内容を置き換える
• delete_draft : 下書きを削除する
• send_draft : 既存の下書きを送信する

設定管理

自動転送

• get_auto_forwarding : 自動転送設定を取得する
• update_auto_forwarding : 自動転送設定を更新する

IMAP設定

• get_imap : IMAP設定を取得する
• update_imap : IMAP設定を更新する

POP設定

• get_pop : POP設定を取得する
• update_pop : POP設定を更新する

休暇対応者

• get_vacation : 休暇通知設定を取得する
• update_vacation : 休暇応答の更新

言語設定

• get_language : 言語設定を取得する
• update_language : 言語設定を更新する

代表者

• list_delegates : アカウント委任者を一覧表示する
• get_delegate : 特定のデリゲートを取得する
• add_delegate : 代理人を追加する
• remove_delegate : 委任を削除する

フィルター

• list_filters : メールフィルターの一覧
• get_filter : 特定のフィルターを取得する
• create_filter : 新しいフィルターを作成する
• delete_filter : フィルターを削除する

転送先アドレス

• list_forwarding_addresses : 転送先アドレスの一覧
• get_forwarding_address : 特定の転送先アドレスを取得する
• create_forwarding_address : 転送先アドレスを作成する
• delete_forwarding_address : 転送先アドレスを削除する

送信者設定

• list_send_as : 送信者エイリアスの一覧
• get_send_as : 特定の送信者エイリアスを取得する
• create_send_as : 送信者エイリアスを作成する
• update_send_as : 送信者エイリアスを更新する
• patch_send_as : 送信者エイリアスの部分的な更新
• verify_send_as : 確認メールを送信する
• delete_send_as : 送信者エイリアスを削除する

S/MIME設定

• list_smime_info : S/MIME設定を一覧表示する
• get_smime_info : 特定のS/MIME設定を取得する
• insert_smime_info : 新しいS/MIME設定をアップロードする
• set_default_smime_info : デフォルトの S/MIME 設定を設定する
• delete_smime_info : S/MIME設定を削除する

貢献

貢献は大歓迎です！問題、貢献、連絡先に関するガイドラインについては、 CONTRIBUTING.md をご覧ください。