Gmail MCP

🚀 Gmail MCP 設定ガイド

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

🚀 クイックスタート

📦 インストール

1. Google API 認証情報の取得

1. Google Cloud Console にアクセスします。
2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択します。
3. プロジェクトのGmail APIを有効にします。
   • 「APIs & Services」>「Library」に移動します。
   • 「Gmail API」を検索し、有効にします。
4. OAuth認証情報を作成します。
   • 「APIs & Services」>「Credentials」に移動します。
   • 「認証情報を作成」>「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サーバーをClaudeの設定ファイルに追加します。

{
  "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 を実際のプロジェクトパスに置き換えます。
• command パスを、インストールした uvx 実行ファイルに合わせて調整します。
• 正しい認証情報とトークンファイルのパスを提供します。

高度な使用法

Claudeは以下のツールを利用できるようになります。

1. メールの検索

あなたのGmailアカウント内でメールを検索します。 使用例: "example@gmail.com からのすべてのメールを検索"

2. メール内容の取得

特定のメールの完全な内容を取得します。 使用例: "件名が '明日の会議' のメールの全文を表示"

3. メッセージの一覧表示

Gmail受信トレイ内の最近のメールを一覧表示します。 使用例: "最近の5通のメールを一覧表示"

🔧 環境変数の設定

環境変数を使用して、認証情報とトークンファイルのパスを設定することができます。

• GMAIL_CREDS_PATH：認証情報のJSONファイルのパス
• GMAIL_TOKEN_PATH：トークンのJSONファイルのパス

プロジェクトのルートディレクトリに .env ファイルを作成し、これらの変数を追加することで簡単に設定できます。