Connect your inbox to the Gemini app
as a custom connected app
Add one URL under Connected Apps on gemini.google.com and Gemini can read, search, send, reply, forward, schedule and organize your real mail, on the web and in the mobile app.
On gemini.google.com, open Settings, Connected Apps, and under Custom apps add a custom app with the MCP server URL https://mcpemails.com/api/mcp. Click Next and follow the on-screen sign-in to authorize with MCPEmails. Google currently offers custom apps to users 18 and over in the US, signed in with a personal Google Account, with Keep Activity on, in English.
How the Gemini app connects: OAuth, no API key
Google's setup form expects an MCP server that supports Dynamic Client Registration, and this one does: the Gemini app registers itself with RFC 7591 dynamic client registration, so there is no client ID to create and nothing to enter under Advanced features. It then authorizes with authorization code plus PKCE using S256. No client secret is ever transmitted, and the token carries only the scopes you approve on our consent screen. The access token it receives lasts an hour and refreshes itself; it is listed in Dashboard, API Keys as OAuth: followed by the client name, which is where you revoke the connection.
The one value you need
Everything on this page is a way of getting this URL into Gemini.
| Field | Value |
|---|---|
| MCP server URL | https://mcpemails.com/api/mcp |
| Transport | Streamable HTTP (MCP 2025-06-18) |
| Authentication | OAuth 2.1, authorization code with PKCE. No API key. |
How to connect Gemini to your inbox
Four steps. The first two are the same for every client, the rest are specific to this one.
Create a free account and connect a mailbox
Sign up at mcpemails.com, no card required, then go to Dashboard, Inboxes, Connect Inbox. Outlook and Microsoft 365 connect with Sign in with Microsoft; Gmail, iCloud, Fastmail, Yahoo, Zoho and Yandex take an app-specific password; anything else connects over plain IMAP and SMTP. The free plan holds one inbox, forever.
Open Connected Apps on the web
On your computer, go to gemini.google.com. At the bottom, click Settings, then Connected Apps. Custom apps can only be added in the web app.
Add a custom app
Under Custom apps, use the Add a custom app link to get started field, or click Add a custom app if you already have one. Enter https://mcpemails.com/api/mcp as the MCP server URL and leave Advanced features closed.
Click Next and authorize
Click Next and follow the on-screen instructions. You are sent to MCPEmails to sign in and approve the scopes you want Gemini to hold.
Call it with @
In a chat, type @ and select the MCPEmails app to make sure Gemini uses it for that prompt. Once connected it is also available in the Gemini mobile app.
Official Gemini documentation for remote MCP servers: https://support.google.com/gemini/answer/17209137
Wondering which mailbox to connect first? See the provider compatibility matrix
What trips people up in Gemini
Custom apps are US, personal accounts and English only for now
Google lists the requirements as being 18 or over and in the US, signed in with a personal Google Account, and having Keep Activity on. Work and school Google Accounts cannot add a custom app yet, and the feature is English only. If Custom apps does not appear under Connected Apps, check those first. Google's help page names no paid plan for custom apps.
Do not fill in Advanced features
The form offers a place for credentials behind Show more next to Advanced features. That is for servers without Dynamic Client Registration. This server supports it, so leave it empty and let Gemini register itself. There is no client ID or secret to create on the MCPEmails side.
Gemini confirms writes, and you can narrow the scopes too
Google says Gemini currently asks for manual confirmation before any write action. On top of that, the consent screen lets you hand Gemini read:email and search:email alone, which is enough for triage and finding things, or you can turn on human approval in the dashboard so every send waits for a person.
Limits worth knowing
- Requests are rate limited to 100 per minute, 1,000 per hour and 10,000 per day per key, plus your plan ceiling on billable actions.
- The server is request and response only. There are no webhooks and no server-initiated events, so new mail never wakes your agent by itself. To react to arriving mail, poll on a schedule.
- Mail is fetched live from your provider on every call and never stored. Only the encrypted OAuth token or app password is kept, so a revoked token or a changed mailbox password ends access immediately.
Gemini and email, answered
How do I connect email to the Gemini app?
On gemini.google.com, open Settings, Connected Apps, and under Custom apps add a custom app with the URL https://mcpemails.com/api/mcp. Click Next, sign in to MCPEmails and approve the scopes. Gemini then has tools for reading, searching, sending, replying, forwarding, organizing and scheduling mail, on the web and in the mobile app.
Do I need an API key for Gemini?
No. The Gemini app registers itself through Dynamic Client Registration and signs you in with OAuth, so nothing secret is typed into the form. A bearer key is available for other clients that cannot do that.
Why don't I see Custom apps in Connected Apps?
Google currently offers custom apps only to users 18 and over in the US, signed in with a personal Google Account, with Keep Activity on, in English. Work and school accounts are not supported yet. Custom apps are added in the web app at gemini.google.com, not in the mobile app.
Which mailboxes can Gemini reach this way?
Outlook.com and Microsoft 365 over Sign in with Microsoft, where a work account may need an IT admin to approve the app once; Gmail, iCloud, Fastmail, Yahoo, Zoho and Yandex with an app-specific password; and any other mailbox that speaks IMAP and SMTP on the standard ports. The client sees them all through the same connection: your agent calls inbox_list first to discover every connected mailbox and its id, so there are no UUIDs to paste anywhere.
Can Gemini send email without me seeing it?
Only if you let it. Sending is gated on the send:email scope, so a token without that scope cannot send at all, and Google says Gemini asks you to confirm write actions. An inbox owner can also require human approval in the dashboard, which holds every send, reply, forward, draft send and scheduled send until a person releases it.
Is my email stored on your servers?
No. Every message is fetched live from your provider for the request that asked for it and handed straight to your client. Only the encrypted OAuth token or app password is kept, so future calls can authenticate. Revoking the OAuth entry in Dashboard, API Keys, or deleting the inbox, ends the connection at once. In Gemini, More details, Remove app also unlinks the server from your Google Account.
Put your inbox in the Gemini app
One URL, one sign-in. One inbox free forever, no card required.