Gmail · sallytion — Claude Code MCP server: what it does, how to install
Connects your Gmail account via standard IMAP and SMTP without OAuth2 setup. Read inbox items, run searches, and send emails directly through your agent.
no license updated 2026-10-29
Open on GitHubWhat Gmail does
The server exposes three tools to your coding assistant: listMessages to inspect recent inbox messages, findMessage to locate specific emails using standard Gmail query syntax, and sendMessage to compose and deliver emails with optional cc and bcc headers.
Instead of registering apps in Google Cloud Console, this implementation relies on direct socket connections to IMAP on port 993 and SMTP on port 587. You can run it via Node.js after running npm run build or inside a container using Docker. Updating the host values in .env also allows redirecting the server to Outlook or third-party providers.
Direct login using your primary Google account password fails immediately: you must activate two-factor authentication and generate a dedicated 16-character app password under account security settings.
What it helps with
- inspect recent inbox messages without leaving the terminal or editor
- locate conversations using query syntax like
has:attachmentoris:unread - dispatch outgoing emails with subject lines and recipients via SMTP
Example prompts for the agent
- List the last 15 emails from my inbox
- Find unread messages with subject invoice
- Send an email to [email protected] with subject Deployment update and body Build succeeded
How to install Gmail
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Gmail
How to install Gmail in Claude Code?
Build the container using npm run docker:build and run docker run --rm -i --env-file .env email-mcp-server, adding that command under the mcpServers entry in your configuration file.
What tools does this MCP server provide?
It exposes listMessages to retrieve recent mail, findMessage to query messages by criteria, and sendMessage to transmit outgoing emails.
Is a Google Cloud OAuth setup required?
No Google Cloud project or OAuth consent flow is required. The server connects over standard IMAP and SMTP using a 16-character Google app password.
Similar MCP servers
All MCP servers for Notes, tasks and projects →Gmail by other authors comes first.