MCP server that proxies Gmail API access through OAuth and lets clients read, search, send, modify, and manage Gmail messages, threads, drafts, labels, filters, attachments, and vacation settings. It does not store tokens itself; it forwards OAuth and API requests between the MCP client and Google.
From the registry: Allow AI systems to read, send, archive, and manage emails via Gmail.
$ git clone https://github.com/domdomegg/gmail-mcp && cd gmail-mcp && npm install && npm run build$ GOOGLE_CLIENT_ID=<your-client-id> GOOGLE_CLIENT_SECRET=<your-client-secret> MCP_TRANSPORT=http npm startPlease install the `gmail-mcp` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Google OAuth credentials** — Create OAuth 2.0 Web application credentials, enable Gmail API, and add http://localhost:3000/callback as redirect URI (https://console.cloud.google.com/)
- **Clone and install** — Clone the repo and install dependencies Run: `git clone https://github.com/domdomegg/gmail-mcp && cd gmail-mcp && npm install && npm run build` (https://github.com/domdomegg/gmail-mcp)
- **Start the server** — Run with OAuth credentials in env; server listens on http://localhost:3000/mcp Run: `GOOGLE_CLIENT_ID=<your-client-id> GOOGLE_CLIENT_SECRET=<your-client-secret> MCP_TRANSPORT=http npm start`
Canonical MCP server config (HTTP transport):
- url: `http://localhost:3000/mcp`
Note: Server acts as an OAuth proxy to Google; the MCP client handles OAuth flow via well-known endpoints on the same host. Change the port with PORT=<port>.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.GOOGLE_CLIENT_IDrequiredGoogle OAuth client ID used to authenticate with the Gmail APIGOOGLE_CLIENT_SECRETrequiredGoogle OAuth client secret used to authenticate with the Gmail APILightweight DMARC parser: auto-fetch email reports, visualize compliance in a single all-in-one app