Gmail MCP

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Allows searching and retrieving emails from a Gmail account, with capabilities to search for specific emails, retrieve full email content, and list recent messages from the inbox.

  • Uses Google Cloud Console for API credentials and OAuth authentication to enable Gmail access.

Gmail MCP

Claude が Gmail アカウントからメールを検索して取得できるようにします。

設定

1. Google API認証情報を取得する

  1. Google Cloud Consoleにアクセスする
  2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択してください
  3. プロジェクトで Gmail API を有効にする
    • 「APIとサービス」>「ライブラリ」に移動します
    • 「Gmail API」を検索して有効にします
  4. OAuth 資格情報を作成します。
    • 「APIとサービス」>「認証情報」に移動します
    • 「認証情報を作成」>「OAuthクライアントID」をクリックします
    • アプリケーションの種類として「デスクトップアプリケーション」を選択します
    • クライアントに名前を付けて「作成」をクリックします
  5. 資格情報JSONファイルをダウンロードする
  6. プロジェクトディレクトリにcredentials.jsonとして保存します。

2. アプリケーションを承認する

認証コマンドを実行してトークンを生成します。

uv run gmail-mcp auth --creds-path credentials.json --token-path token.json

ブラウザウィンドウが開きますので、Googleアカウントにログインして必要な権限を付与してください。権限付与後、プロジェクトディレクトリにtoken.jsonファイルが作成されます。

クロードとの設定

Claude 構成ファイルに Gmail MCP サーバーを追加します。

{ "mcpServers": { "gmail": { "args": [ "--from", "git+https://github.com/vinayak-mehta/gmail-mcp", "gmail-mcp" ], "command": "/Users/username/.local/bin/uvx", "env": { "GMAIL_CREDS_PATH": "/Users/username/path/to/gmail-mcp/credentials.json", "GMAIL_TOKEN_PATH": "/Users/username/path/to/gmail-mcp/token.json" } } } }

必ず次の点に注意してください:

  • /Users/username/path/to/gmail-mcpを実際のプロジェクトパスに置き換えます。
  • インストールしたuvx実行ファイルへのcommandパスを調整します
  • credentials.jsonおよびtoken.jsonファイルへの正しいパスを指定します

クロードは次のツールにアクセスできるようになります。

1. メールを検索する

Gmail アカウントでメールを検索します。

例のプロンプト:example@gmail.comからのすべてのメールを検索」

2. メールの内容を取得する

特定の電子メールの全内容を取得します。

プロンプトの例: 「「明日の会議」という件名のメールの全内容を表示してください」

3. メッセージの一覧

Gmail の受信トレイから最近のメッセージを一覧表示します。

例のプロンプト: 「最近のメール 5 件をリストしてください」

環境変数

環境変数を使用して、資格情報とトークン ファイルへのパスを設定できます。

  • GMAIL_CREDS_PATH : credentials.json ファイルへのパス
  • GMAIL_TOKEN_PATH : token.json ファイルへのパス

簡単に構成できるように、これらの変数を含む.envファイルをプロジェクト ルートに作成します。

-
security - not tested
A
license - permissive license
-
quality - not tested

Claude が Gmail アカウントからメールを検索および取得できるようにするサーバー。メールの検索、特定のメールの完全な内容の取得、最近のメッセージの一覧表示などの機能をサポートします。

  1. Setup
    1. 1. Get Google API Credentials
    2. 2. Authorize the Application
  2. Configuring with Claude
    1. 1. Search Emails
    2. 2. Get Email Content
    3. 3. List Messages
  3. Environment Variables
    ID: r0rf7w4hi6