Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http gmail https://gmail.run.tools
Open on GitHub

What 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.tools

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 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.

gmail pulsemcp Hooks Gmail into an AI assistant: read threads, search, label, draft and send. Works for personal accounts and Google Workspace. CX Codex +1 ★ 81repo stars Gmail domdomegg Connects an AI agent to Gmail for searching, reading, sending, and managing mail. Useful for email-driven workflows and automation. CX Codex +1 ★ 12repo stars Gmail sallytion Connects your Gmail account via standard IMAP and SMTP without OAuth2 setup. Read inbox items, run searches, and send emails directly through your agent. CX Codex +1 google-gmail acedatacloud google-gmail is a Claude Code skill for searching Gmail, reviewing threads, and handling labels or attachments. Sending and other write actions require granted scopes and user confirmation. CX Codex +1 231installs gws-gmail-reply official googleworkspace gws-gmail-reply is a Claude Code skill that replies to Gmail messages while preserving conversation threads, or saves replies as drafts from the terminal. CX Codex +1 36,700installs gws-gmail-send official googleworkspace Exposes gws gmail +send to the agent. Sends Gmail messages with attachments, CC/BCC, HTML body and sender aliases. CX Codex +1 76,800installs gmail-to-crm-pipeline OneWave-AI gmail-to-crm-pipeline reads unread Gmail inquiries, scores each lead against your ICP, and writes qualified ones into Supabase. Replies stay as drafts. CX Codex +1 260installs gws-gmail-triage davila7 gws-gmail-triage displays a summary of unread Gmail inbox messages with sender, subject, and date using the Google Workspace CLI. CX Codex +1 78installs gmail-skill idanbeck Reads, searches and sends Gmail messages, and looks up Google contacts. Useful when the agent has to triage a mailbox or prepare a draft. CX Codex +1 3,600installs

More in the catalog

Project sponsors

Companies that keep this analytics open