Gmail · gmail — Claude Code MCP server: search and triage inbox messages
This MCP server lets an agent search, read, send, and organize Gmail messages. Use it when email actions need to run from an IDE.
no license 57,738 installs updated 2025-11-26
claude mcp add --transport http gmail https://gmail.run.toolsWhat Gmail does
Gmail gives the agent access to mailbox tasks such as message search, reading, sending, replies, and forwarding. It can create, edit, list, and remove drafts, work with conversation threads, and manage custom labels. Messages may be archived, moved to Trash, reported as spam, or handled through inbox triage.
The tool set includes separate actions for emails, threads, headers, drafts, labels, and attachment metadata. When sending or replying, a local attachment can be supplied with a URI such as file:///absolute/path/to/file. Reading an attachment returns its filename, MIME type, size, and Gmail attachment id when available, not its file contents.
Actions run through the connected Gmail account, so that account must be connected before mailbox operations can work. Bulk label changes and triage handle up to 50 messages per call. Repeating a query-based call can move to another result chunk, so blind retries can affect more messages.
What it helps with
- search Gmail messages by query
- read a complete email thread
- draft and send a reply
- apply labels to selected messages
- forward an email with an attachment
Example prompts for the agent
- Search Gmail for messages from
[email protected]received last month and list their subjects. - Write a reply draft for the latest message in this thread.
- Find promotional emails and move them to Spam.
How to install Gmail
Platform CLI: remote server
claude mcp add --transport http gmail https://gmail.run.toolsPlatform CLI: remote server
codex mcp add gmail-gmail --url https://gmail.run.toolsConfig file
{
"mcpServers": {
"gmail-gmail": {
"url": "https://gmail.run.tools"
}
}
}Config file
{
"servers": {
"gmail-gmail": {
"type": "http",
"url": "https://gmail.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http gmail-gmail https://gmail.run.toolsStep 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 do I install Gmail in Codex?
Run codex mcp add gmail-gmail --url https://gmail.run.tools.
What does Gmail do?
It lets an agent search, read, send, reply to, and forward Gmail messages. It also handles drafts, threads, labels, archiving, Trash, spam reports, and inbox triage.
What does Gmail need to work?
A Gmail account must be connected to the MCP service before mailbox actions can run. Local files attached to outgoing messages use a URI such as file:///absolute/path/to/file.
Similar MCP servers
All MCP servers for Agent setup: memory, context, orchestration →Gmail by other authors comes first.