Gmail MCP

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. アプリケーションを承認する

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

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

クロードとの設定

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

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

• /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ファイルをプロジェクト ルートに作成します。