gmail-read-mcp

単一のメールボックスに限定された読み取り専用のGmail MCPサーバー。stdio上で2つのツールを公開します:

• list_emails - 日付範囲で受信したメールを一覧表示: メタデータ+スニペット、古い順(最大500件)

• read_email - IDで1件のメールの完全なヘッダーと本文テキストを読み取る

書き込み、送信、ラベル付け、削除の機能はありません。すべての結果には、メールボックスにサインインしている誰でもメールを開けるjump_urlディープリンク(rfc822msgid:検索)が含まれます。メールボックス自体から送信されたメール(チームの返信)はデフォルトで除外され、スパムとゴミ箱は常に除外されます。

Google OAuthのセットアップ

1. Google Cloudプロジェクトを作成し(本番プロジェクトとは別に — 同意画面はプロジェクトごとです)、Gmail APIを有効にします。

2. OAuth同意画面を内部に設定します(gmail.readonlyスコープの制限付きスコープ検証をスキップします)。

3. タイプデスクトップアプリのOAuthクライアントを作成し、クライアントJSONをダウンロードします。

4. 対象のメールボックスとしてサインインして、1回限りの同意フローを実行します:

   node scripts/gmail-oauth-once.mjs <path-to-client-secret.json>

   リフレッシュトークンと、それがバインドされているメールボックスが出力されます。

リフレッシュトークンに有効期限はありませんが、Googleはアカウントのパスワードが変更されるとGmailスコープのトークンを取り消します。サーバーがinvalid_grantで失敗し始めた場合は、手順4を再実行してGMAIL_REFRESH_TOKENを置き換えてください。

Related MCP server: Gmail MCP Server

ローカルセットアップ

cp .env.example .env
# Fill in GMAIL_CLIENT_ID, GMAIL_CLIENT_SECRET, GMAIL_REFRESH_TOKEN
npm install
npm start

テスト

npm test