Vinkius

Gmail MCP. Automate your inbox triage and correspondence.

Gmail MCP connects your personal or enterprise Gmail account directly to your AI agent. Read full email threads, find specific messages using advanced search queries, draft replies, and organize your entire inbox—all without leaving your IDE or chat client. It handles everything from simple labeling to complex batch operations.

Gmail MCP is compatible with Claude Claude
Gmail MCP is compatible with ChatGPT ChatGPT
Gmail MCP is compatible with Cursor Cursor
Gmail MCP is compatible with Gemini Gemini
Gmail MCP is compatible with Windsurf Windsurf
Gmail MCP is compatible with VS Code VS Code
Gmail MCP is compatible with JetBrains JetBrains
Gmail MCP is compatible with Vercel Vercel
See Vinkius in Action

Give Claude and any AI agent real-world access

Waiting for input…

AI Agent
Gmail

What AI agents can do with The Gmail MCP with 29 Tools

These tools give your agent granular control over every aspect of your mailbox, from composing emails to managing complex label filters.

Make your AI actually useful.

Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.

Start using Gmail MCP

Batch Delete Messages

Permanently deletes multiple messages in bulk. Remember, this action cannot be undone.

Create Inbox Filter

Sets up a rule that automatically adds or removes labels, forwards, or stars...

List Mailbox History

Retrieves the history ID needed to track mailbox changes over time for...

List Gmail Messages

Lists messages in your inbox, allowing you to use advanced search syntax like...

Get Message Content

Reads the complete text and metadata for a single, specific email message.

Send Email

Composes and sends a new email immediately, supporting full HTML or plain text bodies and reply threading.

Send Draft

Dispatches an existing draft message that you previously composed.

Get Attachment

Downloads a specific file attached to an email using its ID and size information.

Modify Message Labels

Adds or removes labels from one or more messages, marking them as read or applying...

Trash Gmail Message

Moves selected messages into the trash folder.

Untrash Gmail Message

Recovers a message that was previously moved to the trash.

Batch Modify Messages

Applies label changes (like marking all as read or archiving) across an entire group of messages using their IDs.

List Gmail Threads

Lists grouped conversation threads, supporting advanced search syntax via the 'q' parameter.

Get Thread Details

Retrieves the entire historical chain of emails, including all messages and headers...

List Mailbox Labels

Lists every system and custom label currently available in your mailbox (e.g....

Get Label Details

Fetches specific metadata about a defined label.

Create Label

Creates a new custom tag or category for your emails.

Delete Label

Permanently removes a custom label from the system.

List Drafts

Retrieves IDs and snippets of all drafts you have saved, showing where they are located.

Get Draft

Reads the full content of a specific draft so you can review it before sending.

Create Draft

Starts a new email draft that you can save and edit later for later use.

Update Draft

Edits the content or recipient list of an existing saved draft.

Delete Draft

Permanently removes a specific email draft from your drafts folder.

Get Vacation Settings

Checks the current status of your automated out-of-office reply.

Update Vacation Settings

Activates or changes your automatic vacation auto-responder messages and dates.

List Inbox Filters

Displays all the automated rules (filters) currently set up to manage incoming mail.

Get Gmail Profile

Retrieves basic statistics and identity information about your mailbox account.

Verify Api Connection

Runs a quick check to ensure the connection between the AI agent and Gmail is active.

List Unread Emails

Lists all messages that have not yet been opened or marked as read in your inbox.

Find Emails From Sender

Searches and lists any emails sent to you by a specific sender address.

Security and governance baked right in.

Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.

Gmail MCP is compatible with Claude

Claude AI

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.

2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.

3

Start a conversation

Open a new chat. The Gmail integration is available immediately — no restart needed.

Choose How to Get Started

Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.

Build Your Own

Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.

  • Import from OpenAPI, Swagger, or YAML specs
  • Create Agent Skills with progressive disclosure
  • Deploy to edge with MCPFusion framework
  • Built in DLP, auth, and compliance on each call
  • Real time usage dashboard and cost metering
  • Publish to catalog or keep private
Start building

Make Your AI Do More

Start with Gmail, then connect any of our 5,200+ other servers whenever your AI needs more. One click, no limits.

  • Use this MCP plus 5,200+ others, all in one place
  • Add new capabilities to your AI anytime you want
  • Connections are secured and governed automatically
  • Track usage and costs across all your servers
  • Works with Claude, ChatGPT, Cursor, and more
  • New servers added to the catalog weekly
Gmail MCP server cover

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Gmail. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

VINKIUS CLOUD

Cloud Hosted

Managed infra

V8 Isolated

Sandboxed per request

Zero-Trust Proxy

No stored credentials

DLP Enforced

Policy on each call

GDPR Compliant

EU data residency

Token Compression

~60% cost reduction

Your data is protected. See how we built it.

The inbox overload is exhausting.

Every day, you open your email client. You click through dozens of tabs. You run a quick search for that one thread about Q3 budget cuts, only to find three similar conversations and have to manually read them all. If the information is spread across labels, drafts, and deep message chains, it takes time away from actual work just sorting through noise.

With this MCP integrated into your agent, you tell it what you need—for example, 'Show me all unread messages about budget cuts sent last week.' Your agent handles the complex search queries, pulling the precise details using tools like 'list_gmail_messages' and presenting only the actionable context. You get clarity without the clicks.

Gmail MCP: Structured Email Automation

Manual tasks that vanish include setting up filters, which used to meant logging into Gmail settings and clicking through multiple menus; manually tracking conversation history by opening every single message in a thread; or having to copy the sender's name from one email just so you can search for them later.

Now, your agent handles all that logic. It reads entire conversations via 'get_thread_details' and applies filters using 'create_inbox_filter', making your inbox work for you instead of forcing you to work on it.

What Gmail MCP does for your AI

Managing an overflowing inbox used to mean jumping between tabs, running manual searches for keywords, and copy-pasting information into drafts. This MCP lets you automate the entire process. You can ask your agent to summarize a massive email thread or pull out key action items from dozens of messages in minutes.

Need to find every unread message from your boss with an attachment? Your agent runs advanced queries across your whole mailbox, instantly surfacing exactly what matters right now. Beyond just reading, you control the flow: mark entire groups of emails as read, create new label filters, or even draft and send full responses directly within existing conversation threads.

By connecting this MCP through Vinkius, any compatible AI client treats your Gmail account like a native function—allowing true automated email handling wherever you work.

Built · Hosted · Managed by Vinkius Gmail MCP - Manage Emails & Automate Inbox
Server ID 019d75a6-e987-70be-aaaf-a230311b2d4b
Vinkius Inspector
Compliance Grade A+
Score 98.33/100
Vinkius Inspector Badge — Score 98.33/100

Frequently asked questions about Gmail MCP

How do I search my emails in Gmail with this MCP? +

You use the 'list_gmail_messages' tool, which accepts standard Gmail search syntax. You can ask your agent to find messages using operators like 'from:boss@company.com is:unread'.

Can I reply to an email thread from my IDE? +

Yes. Your agent uses the 'send_email' tool, which supports proper reply threading by referencing existing message headers so your response looks natural in Gmail.

What is the difference between listing messages and reading content with Gmail MCP? +

Listing messages ('list_gmail_messages') gives you IDs and basic metadata. To read the full text, attachments, or headers, you must use 'get_message_content' for a specific message ID.

How do I mark all emails as read in bulk using Gmail MCP? +

You can use the 'batch_modify_messages' tool. By providing an array of message IDs and instructing the agent to remove the UNREAD label, it marks them all as read.

Does this MCP handle my drafts folder? +

Yes. You can use 'list_drafts' to see what you saved, 'get_draft' to review the content, and then 'send_draft' to dispatch it when ready.