必要な値は1つだけ
~/.gemini/settings.jsonのmcpServersに、httpUrlフィールドでhttps://mcpemails.com/api/mcpを指定したエントリを1つ追加します。初回接続時にCLIがOAuthのメタデータを検出し、ブラウザーでの認証を自動で開始します。または、gemini mcp add --transport http mcpemails https://mcpemails.com/api/mcpを実行し、/mcp auth mcpemailsでログインします。
| 項目 | 値 |
|---|---|
| MCPサーバーURL | https://mcpemails.com/api/mcp |
| トランスポート | Streamable HTTP (MCP 2025-06-18) |
| 認証 | OAuth 2.1、PKCE付き認可コード。APIキーは不要です。 |
Gemini CLIの接続方法：OAuth、APIキー不要
Gemini CLIはこのサーバーに対して標準のMCP OAuthフローを実行します。RFC 7591の動的クライアント登録で自身を登録するため、クライアントIDを作成する必要はなく、S256による認可コードとPKCEで認可します。クライアントシークレットが送信されることはなく、トークンには同意画面で承認したスコープだけが含まれます。取得したアクセストークンの有効期間は1時間で、自動で更新されます。ダッシュボードの「APIキー」にOAuth:とクライアント名の形で表示され、そこから接続を取り消せます。
Gemini CLIを受信トレイに接続する方法
手順は4つです。最初の2つはどのクライアントでも同じで、残りはこのクライアント固有の手順です。
無料アカウントを作成してメールボックスを接続
mcpemails.comで新規登録し（カード登録は不要）、ダッシュボードの「受信トレイ」でメールボックスを接続します。受信トレイ1つはずっと無料です。
settings.jsonを開く
すべてのプロジェクトで使うなら~/.gemini/settings.jsonを、1つのプロジェクトだけなら.gemini/settings.jsonを編集します。
サーバーを追加
下のエントリをmcpServersの中に追加します。ここでStreamable HTTPサーバーを指定するフィールドはhttpUrlです。またはgemini mcp add --transport http mcpemails https://mcpemails.com/api/mcpの1行で追加することもできます。
接続
初回接続時に、CLIがサーバーのメタデータからOAuthを自動で検出し、ブラウザーでの認証を開始します。CLIに持たせたいスコープを承認してください。ログインはCLI内で/mcp auth mcpemailsを実行すれば、いつでもできます。
{
"mcpServers": {
"mcpemails": {
"httpUrl": "https://mcpemails.com/api/mcp"
}
}
}リモートMCPサーバーに関するGemini CLIの公式ドキュメント： https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md
どのメールボックスから接続するか迷っていますか。 プロバイダー互換性の一覧を見る
Gemini CLIでつまずきやすいポイント
httpUrlはurlとは別のフィールドで、違いはトランスポート
Gemini CLIの設定では、httpUrlはStreamable HTTPサーバーを意味し、このサーバーはそれにあたります。同じオブジェクト内の他のキーは別のトランスポートを選びます。urlを使うCursor向けガイドからコピーしたスニペットでは、ここで動くStreamable HTTP接続にはなりません。
設定不要にしているのはディスカバリーで、それは401から始まる
CLIに認証先を教える必要はありません。認証なしの呼び出しには401が返り、そのWWW-Authenticateヘッダーが保護リソースのメタデータを指します。そのメタデータが認可サーバーを示し、認可サーバーのメタデータが登録、認可、トークンの各エンドポイントを示します。この連鎖のおかげで、クライアントIDの作成は不要で、URL以外に貼り付けるものもありません。
共有マシンやヘッドレスマシンのCLIでは、キーを使う方法を
ブラウザーでの認証にはブラウザーが必要です。ビルドエージェントや共有マシンでは、その自動処理に必要な範囲だけにスコープを絞ったBearer APIキーを、コミットする設定ファイルではなく環境変数に置くのが適切な設定です。
無料版とGoogle OneのアカウントはAntigravity CLIに移行
2026年6月18日以降、Googleは無料ティアとGoogle OneのアカウントをGemini CLIからAntigravity CLIに移しました。Antigravity CLIでは/mcpと入力してMCPマネージャーを開くか、serverUrlフィールドを使ってmcp_config.jsonにサーバーを追加します。
知っておきたい制限
- リクエストにはキーごとに、プランに応じた1分、1時間、1日単位のレート制限があります。429レスポンスにはRetry-Afterが付きます。
- サーバーはリクエストとレスポンスだけで動作します。Webhookもサーバー発のイベントもないため、新着メールがエージェントを自動で起動することはありません。届いたメールに反応するには、定期的にポーリングしてください。
- メールは呼び出しのたびにプロバイダーからその場で取得され、保存されることはありません。保存するのは暗号化したOAuthトークンまたはアプリ パスワードだけなので、トークンを取り消すかメールボックスのパスワードを変更すれば、アクセスはすぐに終わります。
Gemini CLIとメールに関するよくある質問
Gemini CLIにメールを接続するには？
~/.gemini/settings.jsonのmcpServersに、httpUrlをhttps://mcpemails.com/api/mcpとしたエントリを追加します。初回接続時にCLIがサーバーのメタデータからOAuthを検出し、ブラウザーでの認証を開始します。これで、メールの閲覧、検索、送信、返信、転送、整理、予約送信のツールが使えるようになります。
urlとhttpUrlのどちらを使えばよいですか？
httpUrlです。Gemini CLIの設定ではこのキーがStreamable HTTPトランスポートを選び、このサーバーが使うのはそのトランスポートです。他のクライアントからurlのエントリをコピーすると、サーバーは一覧に表示されてもツールが現れない、というのがよくある原因です。
Googleが公開しているGmail MCPサーバーと同じものですか？
いいえ。Googleは他のサービスと並んでGmailも扱うWorkspace MCPサーバーを公開しており、GoogleだけのワークフローでGmailのみを使うなら、そちらのほうが手早く済みます。MCPEmailsは、メールボックスがすべてGoogleとは限らず、同じURLをClaude、Cursor、ChatGPTでも使う必要がある場合のためのものです。
この方法でGemini CLIが使えるメールボックスは？
Outlook.comとMicrosoft 365は「Microsoftでサインイン」で接続します（職場アカウントでは、IT管理者による一度きりのアプリ承認が必要な場合があります）。Gmail、iCloud、Fastmail、Yahoo、Zoho、Yandexはアプリ パスワードで接続でき、標準ポートでIMAPとSMTPに対応するその他のメールボックスも使えます。クライアントはこれらすべてを同じ接続で扱います。エージェントは最初にinbox_listを呼び出して、接続済みのすべてのメールボックスとそのIDを取得するので、UUIDをどこかに貼り付ける必要はありません。
Gemini CLIが私の知らないうちにメールを送信することはありますか？
許可した場合に限ります。送信にはsend:emailスコープが必要なので、このスコープを持たないキーやトークンでは一切送信できません。さらに、受信トレイのオーナーはダッシュボードで人による承認を必須にでき、その場合は送信、返信、転送、下書きの送信、予約送信のすべてが、人が許可するまで保留されます。
メールはサーバーに保存されますか？
いいえ。メッセージはすべて、それを求めたリクエストのためにプロバイダーからその場で取得され、そのままクライアントに渡されます。保存するのは、以降の呼び出しで認証するための暗号化したOAuthトークンまたはアプリ パスワードだけです。ダッシュボードで受信トレイを削除するか、プロバイダー側でアクセスを取り消せば、接続はすぐに切れます。