Gmail MCP

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

特徴

• メッセージ、スレッド、ラベル、下書き、設定を含む Gmail API を完全にカバーします

• メールの送信、下書き、管理のサポート

• カスタマイズ可能な色と表示設定によるラベル管理

• 会話管理のためのスレッド操作

• 不在通知、IMAP/POP、言語設定などの設定管理

• メールボックスの変更履歴の追跡

• Google Cloud 認証情報を使用した安全な OAuth2 認証

Related MCP server: Gmail MCP Server

前提条件

この 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から次のコマンドを実行します。

npx -y @smithery/cli install @shinzo-labs/gmail-mcp

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

鍛冶屋SDK

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

NPX ローカルインストール

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

{
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": [
        "@shinzolabs/gmail-mcp"
      ]
    }
  }
}

ソースからビルド

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

git clone https://github.com/shinzo-labs/gmail-mcp.git

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

pnpm i && pnpm build

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

{
  "mcpServers": {
    "gmail": {
      "command": "node",
      "args": [
        "/path/to/gmail-mcp/dist/index.js"
      ]
    }
  }
}

設定変数

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

ユーザー管理

• 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 をご覧ください。