Skip to main content
Glama
deenesjakoruzh

Gmail MCP

by shinzo-labs
OverviewInspectSchemaRelated ServersScoreDiscussions
JavaScript
Hybrid
MIT License
4
82
38

Gmail MCP

npmバージョン 鍛冶屋のバッジ

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

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

pnpm i && pnpm build

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

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

設定変数

変数

説明

必須？

デフォルト

AUTH_SERVER_PORT

一時 OAuth 認証サーバーのポート

いいえ

3000

CLIENT_ID

Google API クライアント ID (

GMAIL_OAUTH_PATH

にあります)

リモートサーバー接続の場合ははい

''

CLIENT_SECRET

Google API クライアント シークレット (

GMAIL_OAUTH_PATH

にあります)

リモートサーバー接続の場合ははい

''

GMAIL_CREDENTIALS_PATH

ユーザー資格情報ファイルへのパス

いいえ

MCP_CONFIG_DIR/credentials.json

GMAIL_OAUTH_PATH

Google API クライアント ファイルへのパス

いいえ

MCP_CONFIG_DIR/gcp-oauth.keys.json

MCP_CONFIG_DIR

設定ファイルを保存するディレクトリ

いいえ

~/.gmail-mcp

REFRESH_TOKEN

OAuth リフレッシュ トークン (

GMAIL_CREDENTIALS_PATH

にあります)

リモートサーバー接続の場合ははい

''

PORT

ストリーミング可能な HTTP トランスポート方式のポート

いいえ

3000

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

ユーザー管理

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

One-click Deploy
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

Resources

Tools

View all tools

Appeared in Searches

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/shinzo-labs/gmail-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server