Email

Gmail MCP Server

Connect your account, then chat with AI to run tools.

Gmail is a web-based email service provided by Google, allowing users to send and receive emails, manage their inboxes, and access a suite of productivity tools. It is primarily used for email communication and management.

26 tools
Agent guide included
Start Chatting

Opens MCPBundles Studio with this server selected. After sign-in, chat and run tools from the same thread.

Browse all tools

AI Skill
SKILL.md

Domain knowledge for Gmail — workflow patterns, data models, and gotchas for your AI agent.

Gmail

Tool calls target the authenticated mailbox. Messages live in threads; labels organize them. Which reads and writes succeed depends on what the connected identity is allowed to do.

Data Model

  • Messages — individual MIME parts addressed by id; mailbox search supports Gmail operators (has:attachment, newer_than:7d, etc.). Load full body content when snippets are not enough.
  • Threads — conversational groupings; expand the whole thread when context matters.
  • Labels — system mailboxes (INBOX, SENT, …) plus user-defined tags; label mutations fail when the connection cannot change mailbox state.
  • Drafts — unsent composer state; creating or sending drafts fails when composition or send is not permitted.
  • Filters — mailbox rules for labeling/forwarding; managing them fails when those settings are not exposed for the connection.
  • History — incremental sync via startHistoryId checkpoints.

Gotchas

  • historyId: Persist the latest checkpoint from message/thread payloads for reliable delta sync.
  • Message vs thread ids: Never interchange them—per-message edits need message ids.
  • Permission failures on write or settings: Usually means send, label change, filter edit, or similar is outside what the connection allows—stick to reads or narrower operations.
  • Batching: When you already hold many message ids, batch content retrieval reduces round trips.

Tools in this Server (26)

Gmail Batch Modify Message Labels

Add/remove labels on multiple Gmail messages in one call.

Gmail Create Draft

Create a Gmail draft. Supports reply drafts via thread_id + in_reply_to + references.

Gmail Create Filter

Create a Gmail filter.

Gmail Create Label

Create a new Gmail label.

Gmail Delete Filter

Delete a Gmail filter by ID.

Gmail Delete Label

Delete a Gmail label by ID.

Gmail Fetch Labels Details

Fetch detailed information about a specific Gmail label using its label ID. Use this when you need in-depth details about a label, like its type and m...

Gmail Fetch Messages Details

Fetch a Gmail message by ID. Use format=metadata when you only need headers; use format=full to include payload.

Gmail Fetch Threads Details

Get all emails within a specific thread using the thread's unique ID. Ideal for reviewing entire conversations in one place. It returns detailed threa...

Gmail Get Attachment Content

Fetch a Gmail attachment, store it in S3, and return a short-lived download URL.

Gmail Get Message Content

Fetch a Gmail message and return normalized content (headers + plain-text body). Skips attachments.

Gmail Get Messages Content Batch

Fetch up to 25 Gmail messages and return normalized content (headers + plain-text body). Skips attachments.

Gmail Get Thread Content

Fetch a Gmail thread and return normalized content for all messages (headers + plain-text bodies). Skips attachments.

Gmail Get Threads Content Batch

Fetch multiple Gmail threads and return normalized content for each. Skips attachments.

Gmail List Drafts

List saved email drafts in Gmail. Supports pagination and optional inclusion of spam/trash.

Gmail List Filters

List Gmail filters (settings).

Gmail List History Changes

List Gmail history changes starting from a history ID. Returns history records with message IDs that can be used with gmail_fetch_messages_details or ...

Gmail List Labels

Retrieve all labels present in your Gmail account. Use this to manage or organize your emails based on categories or custom tags. It returns a list of...

Gmail List Message Attachments

List attachments for a Gmail message (attachment_id, filename, mimeType, size).

Gmail List Messages

List Gmail messages. Supports pagination, native Gmail search (q), label filtering, and optional inclusion of spam/trash.

Gmail List Profile

Retrieve your Gmail profile information such as email address, messages total, and threads total. Use this when you need a summary of your account's b...

Gmail List Threads

List Gmail threads. Supports pagination, native Gmail search (q), label filtering, and optional inclusion of spam/trash.

Gmail Modify Message Labels

Add/remove labels on a Gmail message. To archive: remove INBOX. To mark unread: add UNREAD.

Gmail Send Message

Send an email using Gmail. Supports replies via thread_id + in_reply_to + references.

Gmail Update Label

Update an existing Gmail label.

Gmail Validate Token

Validate the Gmail OAuth token and confirm required scopes are granted.

Frequently Asked Questions

What is the Gmail MCP server?

Gmail is a web-based email service provided by Google, allowing users to send and receive emails, manage their inboxes, and access a suite of productivity tools. It is primarily used for email communication and management. It provides 26 tools that AI agents can use through the Model Context Protocol (MCP).

How do I connect Gmail to my AI agent?

Add the MCPBundles server URL to your MCP client configuration (Claude Desktop, Cursor, VS Code, etc.). The URL format is: https://mcp.mcpbundles.com/bundle/gmail. Authentication is handled automatically.

How many tools does Gmail provide?

Gmail provides 26 tools that can be called by AI agents, along with a SKILL.md that gives your AI agent domain knowledge about when and how to use them.

What authentication does Gmail require?

Gmail uses One-click sign in. Gmail requires credentials. Connect via MCPBundles and authentication is handled automatically.

Setup Instructions

Connect Gmail to any MCP client in minutes

https://mcp.mcpbundles.com/bundle/gmail

What is MCP?

Model Context Protocol lets AI tools call external capabilities securely through a single URL. This bundle groups tools behind an MCP endpoint that many clients can use.

Use this bundle in 3 steps

  1. Copy the MCP URL above
  2. Open your AI tool and add a new MCP/connector
  3. Paste the URL and follow any auth prompts

Claude Desktop Users

Skip the manual setup! Use the .mcpb file format for one-click installation. Check the Claude Desktop tab for setup instructions.

Pick your tool tab for exact steps

Select ChatGPT, Cursor, Claude Code, or another tab for copy-paste config.

Ready to use Gmail?

Sign in to connect your credentials and start running tools from the chat.

Gmail MCP Server & Skill — 26 Tools