MCP.Market

Gmail MCP server

by domdomegg·io.github.domdomegg/gmail-mcp·v2.4.0·11 stars
No reviews yet

Allow AI systems to read, send, archive, and manage emails via Gmail.

B83/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B83/100

full report

Adoption
Growing

11 stars210 downloads/wk

Reviews

Write one

Nobody has reviewed Gmail yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Gmail tools (36, 15 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • attachment_get

    Get a message attachment. Returns base64url-encoded data.

  • draft_createwrite action

    Create a new draft email. The draft can be edited and sent later from Gmail.

  • draft_deletewrite action

    Permanently delete a draft

  • draft_get

    Get a specific draft by ID

  • draft_sendwrite action

    Send an existing draft

  • draft_updatewrite action

    Update an existing draft

  • drafts_list

    List all drafts

  • filter_createwrite action

    Create a new email filter

  • filter_deletewrite action

    Delete an email filter

  • filter_get

    Get a specific filter by ID

  • filters_list

    List all email filters

  • get_profile

    Get the current user's Gmail profile including email address

  • label_createwrite action

    Create a new label

  • label_deletewrite action

    Delete a label. System labels cannot be deleted.

  • label_get

    Get a specific label by ID

  • label_updatewrite action

    Update an existing label

  • labels_list

    List all labels in the user's mailbox. Includes both system labels (INBOX, SENT, etc.) and user-created labels.

  • message_archive

    Archive a message by removing the INBOX label. The message remains accessible via search or All Mail.

  • message_deletewrite action

    Permanently delete a message. This cannot be undone. Prefer gmail_message_trash for most cases.

  • message_forward

    Forward an email message to new recipients, including attachments and inline images.

  • message_get

    Get a single message by ID. Consider using gmail_thread_get to get all messages in a conversation.

  • message_modify

    Modify the labels on a message. Use this to archive (remove INBOX), mark as read (remove UNREAD), star, etc.

  • message_sendwrite action

    Send an email message. Can also be used to reply to existing threads.

  • message_trash

    Move a message to the trash. Messages in trash are deleted after 30 days.

  • message_untrashwrite action

    Remove a message from trash

  • messages_batch_deletewrite action

    Permanently delete multiple messages. This cannot be undone.

  • messages_batch_modify

    Modify labels on multiple messages at once

  • messages_list

    List individual messages. Consider using gmail_threads_list instead to group related messages. Use gmail_message_get to fetch full content.

  • thread_deletewrite action

    Permanently delete a thread. This cannot be undone. Prefer gmail_thread_trash for most cases.

  • thread_get

    Get all messages in a thread (conversation). Recommended over gmail_message_get for reading emails.

  • thread_modify

    Modify labels on a thread

  • thread_trash

    Move a thread to trash

  • thread_untrashwrite action

    Remove a thread from trash

  • threads_list

    List or search email threads (conversations). Recommended over messages_list for most use cases.

  • vacation_get

    Get vacation auto-reply settings

  • vacation_set

    Set vacation auto-reply settings. To disable, set enableAutoReply to false.

Public scan report

scanner v0.1.9 · 2026-09-24 · same rubric, same numbers if you re-run it

no findings
  • Code scan91 source files scanned; 91 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 15 days ago15/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 83/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Gmail compares

Against every graded Email MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
83/100
higher than 75% of 916 Email servers
Tools
36
the typical Email server has 7
Tools that change things
42%
typical: 25%. Fewer write tools means less an agent can break
GitHub stars
11
more than 88% of 493 Email servers
Downloads a week
210
more than 71% of 235 Email servers with a package

What its tools let an agent do: 14 read · 11 change · 11 send or post

Install Gmail in Claude Code, Cursor or VS Code

Runs npx -y gmail-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add gmail-mcp -- npx -y gmail-mcp
Add to Cursor

What the publisher says

From the Gmail repository's README, as published. We do not edit it. Read it on GitHub

gmail-mcp

MCP server for Gmail - read, send, archive, and manage emails.

Use Cases

Flight check-in: "Check me in for my flight tomorrow" → finds your confirmation email, extracts the booking reference, and completes check-in with browser use.

Expense submission: "Submit my Amazon purchases from last week as expenses" → finds receipts, extracts amounts/categories, and files them in your expense system.

Package tracking: "Where's my package from Acme?" → finds the shipping notification, extracts the tracking number, and fetches current delivery status.

Find that attachment: "What did we settle on for the budget? Michelle sent me something yesterday" → locates the email and opens the attached spreadsheet.

Vacation mode: "I'm on holiday Dec 20-Jan 2" → sets up Gmail auto-reply, blocks your calendar, and updates your Slack status in one go.

Meeting follow-up: After a call, your assistant reads the Gemini transcript, summarizes key decisions, and drafts a follow-up email with action items.

(These are just examples - any workflow that needs email search, reading, or sending can use this.)

Setup

1. Create Google OAuth credentials

  1. Go to Google Cloud Console
  2. Create a new project (or use existing)
  3. Enable the Gmail API
  4. Go to APIs & Services → OAuth consent screen, set up consent screen
  5. Go to APIs & Services → Credentials → Create Credentials → OAuth client ID
  6. Choose Web application
  7. Add http://localhost:3000/callback to Authorized redirect URIs
  8. Note your Client ID and Client Secret

2. Run the server

GOOGLE_CLIENT_ID='your-client-id' \
GOOGLE_CLIENT_SECRET='your-client-secret' \
MCP_TRANSPORT=http \
npm start

The server runs on http://localhost:3000 by default. Change with PORT=3001.

3. Add to your MCP client

With the server running, follow the instructions on install-mcp, which generates the right config for your MCP client (Claude Code, Claude Desktop, Cursor, Cline, VS Code, and more).

Architecture

This server acts as an OAuth proxy to Google:

graph LR
    A[MCP client] <--> B[gmail-mcp] <--> C[Google OAuth/API]
  1. Server advertises itself as an OAuth authorization server via /.well-known/oauth-authorization-server
  2. /register returns the Google OAuth client credentials
  3. /authorize redirects to Google, encoding the client's callback URL in state
  4. /callback receives the code from Google and forwards to the client's callback
  5. /token proxies token requests to Google, injecting client credentials
  6. /mcp handles MCP requests, using the bearer token to call Gmail API

The server holds no tokens or state - it just proxies OAuth to Google.

Tools

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Gmail: common questions

Is Gmail MCP server safe?
Mostly: it is graded B (83/100). Read the Gmail safety report
How do I install Gmail?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Gmail need an API key?
Yes. The registry entry asks for GOOGLE_ACCESS_TOKEN, GOOGLE_CLIENT_SECRET.
Is Gmail maintained?
The last commit was 56 days ago (2026-09-09). The latest release is v2.4.0.
What can I use instead of Gmail?
Servers from other publishers that do the same job: Fluxmail MCP server, MCPEmails MCP server and Mailbox MCP server. Compare all Gmail alternatives.
How does Gmail compare with other Email MCP servers?
safety score 83/100 (higher than 75% of 916 Email servers); tools 36 (the typical Email server has 7); tools that change things 42% (typical: 25%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Gmail

Same job from other publishers: the closest match first, then the best rated.

All Gmail alternatives →
  • Fluxmail
    Read, search, draft, send, and organize email through Gmail, Outlook, and IMAP/SMTP mailboxes.
    B
  • MCPEmails
    Never-stored live email: read, send and triage Gmail, Outlook / Microsoft 365, or any IMAP mailbox.
    A
  • Mailbox
    Multi-account email MCP server for Gmail, IMAP, and JMAP: search, send, drafts, labels.
    B
  • owlpost
    IMAP/SMTP email for iCloud, Gmail, Proton Bridge and more: search, read, follow threads, send.
    A
  • Mailoo - Email MCP Server
    Email MCP server for AI agents: IMAP/SMTP, Gmail, Outlook, calendar, ManageSieve, AI triage, OAuth2.
    A

More from domdomegg →