CursorのGmail連携で、あるはずのメールが見つからないとき

ブラウザのGmailには、ちゃんとメールがある。

なのに、Cursor側のGmail連携で探すと、0件。

同じ日の他のメールは取れる。

接続は死んでない。

再接続しても、状況が変わらない。

んっ？　となったんですが。

これ、Cursorを仕事で使っている人だと、たまにハマります。

今日から始めるシリーズ「ハル先生のcursor日記」の1回目は、この話です。

結論だけ先に言うと、

探すのは Gmail API 直叩き（例: gog CLI）。

送る・返信するのは Gmail MCP。

この役割分担で、だいたい前に進めます。

何が起きていたか

Cursor の Hosted Gmail MCP は、常にライブのGmail全文を見ているとは限りません。

内部インデックス経由の挙動があり、特定の新着メールだけ、黙って欠けることがあります。

紛らわしいのはここです。

「件名で検索すれば見つかるでしょ」と思いがち。

でも、インデックスにメール自体が無いと、件名でもヒットしません。

「同期遅れかな」と呼ぶと誤解しやすいです。

数時間経っても、再接続しても、出ないことがあるからです。

症状の見分け方

次が揃うと、この問題の可能性が高いです。

• ブラウザのGmailにはメールがある
• MCPでは同じ日の他メールは取れる（接続は死んでいない）
• 特定メールだけ 0件
• 件名・差出人・固有番号・in:anywhere で探しても出ない
• 再接続しても状況が変わらない

「接続不良」と「特定メールだけ欠ける」は、別物です。

同じ時間帯の別送信者が取れるなら、接続そのものは生きています。

補足: Salesforce経由って何？

ここ、初心者向けに少しだけ。

Salesforce（セールスフォース）は、企業が顧客情報や問い合わせ、審査連絡などを管理するためのクラウドサービスです。

自分のパソコンに入れるソフトではなく、送り手の企業側が使っている仕組みです。

そのため、メールの見た目はこうなりやすいです。

• 差出人表示: no-reply@会社名.com のような形
• Gmailの注記: ....bnc.salesforce.com 経由

「あの会社から来たメール」なのに、配送の途中で Salesforce のサーバーを経由している、という意味です。

ブラウザのGmailには普通に届きます。

今回の観察では、こうした Salesforce 経由メールで、MCP 側の取り込み・検索だけが欠けることがありました。

原因の断定ではなく、経験則としての補足です。

他社メールでも、同じ仕組みは起こり得ます。

回避方法の全体像

やりたいこと	使うもの
重要メールを確実に探す	gog など Gmail API 直叩き
メールを送る／返信する	Gmail MCP
MCPが0件のとき最短で進める	ブラウザ確認 → 本文をチャットに貼る

おすすめはシンプルです。

探すは gog。送るは MCP。

gog を使うには、Google Cloud 上の OAuth クライアント（credentials.json）が必要です。

すでに Workspace MCP 等で同じ JSON がある場合は流用できます。

無い場合は、次の節でプロジェクトを1つ作ります。

Google Cloud でプロジェクトを1つ作る（または既存を使う）

個人のGmail API（自分のメールを読むだけ）では、通常すぐ請求されません。

ただ、画面の案内はよく読んでください。

Consoleを開く

1. ブラウザで Google Cloud Console を開く
2. 使いたい Google アカウントでログインする（Gmailを読みたいアカウントと同じでよい）

プロジェクトを選ぶ／作る

1. 画面上部の「プロジェクトを選択」をクリック
2. 既存があればそれを使う
3. 無ければ「新しいプロジェクト」→ 名前を付ける → 作成

Gmail API を有効化する

1. 左メニュー「APIとサービス」→「ライブラリ」
2. 「Gmail API」を検索して開く
3. 「有効にする」をクリック

OAuth同意画面を設定する

1. 「APIとサービス」→「OAuth同意画面」
2. User Type は「外部」（個人Gmail向け）を選ぶ
3. アプリ名などを入力して保存
4. テストユーザーに、ログインする自分のGmailアドレスを追加する

公開アプリにしていない間は、テストユーザー以外はログインできません。

OAuthクライアントIDを作る

1. 「APIとサービス」→「認証情報」
2. 「認証情報を作成」→「OAuthクライアントID」
3. アプリケーションの種類: デスクトップアプリ
4. 名前を付けて作成
5. JSONをダウンロードし、わかりやすい場所に置く

すでに同じ用途の credentials.json がある場合は、この節を飛ばして次へ進んで大丈夫です。

gog のインストール・登録・検索（macOS）

インストール:

brew install steipete/tap/gogcli

コマンド名は gog です。

credentials を登録し、Gmailログイン:

gog auth credentials set ~/.config/gog/credentials.json

gog auth add あなたの@gmail.com 
  --services gmail --gmail-scope readonly --force-consent

あなたの@gmail.com は、実際に検索したいGmailアドレスに置き換えてください。

検索:

gog gmail search 'キーワード OR subject:件名の一部' 
  -a あなたの@gmail.com -p

認証状態の確認:

gog auth list
gog auth status

実例としては、ブラウザにはあるのに MCP では 0件だったメールを、gog で固有キーワード検索したら即座にヒット、というパターンがありました。

同じ日の他メールや、古い同系統メールは MCP で取れていたので、接続死ではなく「特定メールだけ欠ける」タイプでした。

同じ症状のときのチェックリスト

1. ブラウザのGmailにメールはあるか
2. Gmail画面に bnc.salesforce.com 経由 などの注記はないか
3. MCPで差出人／件名／固有IDを試す
4. 同じ時間帯の別送信者は取れるか（接続死活の切り分け）
5. 取れなければ再接続に時間をかけすぎない
6. gog 等のライブAPIで再検索する
7. それでも無理なら本文を貼って作業継続

大事なのは、再接続ループで時間を溶かしすぎないことです。

60%で次の手に進む。

その感覚、Cursor運用でも同じです。ｗ

おわりに

Cursor は便利です。

でも、MCPが「全部見えている」前提で止まると、大事なメールで詰みます。

ブラウザで確認できる。

API直で探せる。

チャットに貼って先へ進める。

道具を切り替えるだけで、仕事は続きます。

「ハル先生のcursor日記」では、こういう現場メモを、できるだけオープンに残していきます。

同じ症状で困っている人の、ショートカットになればうれしいです。

また書きます。