MCP.Market

Multi Gmail MCP server

by gx-55·io.github.gx-55/multi-gmail-mcp·v1.0.1·19 stars

Manage multiple Gmail accounts in Claude Desktop — search, send, reply, draft, and organize.

B78/100grade B
What users say
No reviews yet
Be the first
Safety scan
B78/100

full report

Adoption
Growing

19 stars75 downloads/wk

Reviews

Write one

Nobody has reviewed Multi Gmail yet.

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

Multi Gmail tools (15, 7 write)

write = sends, deletes, buys or posts

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

  • add_label

    Add one or more labels to an email.

  • archive_emailwrite action

    Archive an email by removing it from the inbox.

  • complete_auth

    Finish OAuth2 authentication after the user has opened the URL from initiate_auth

  • create_draftwrite action

    Save an email as a draft without sending.

  • get_emailwrite action

    Fetch the full content of an email by ID.

  • initiate_auth

    Start OAuth2 authentication for a Gmail account.

  • list_accounts

    List all authenticated Gmail accounts.

  • list_labels

    List all Gmail labels for an account.

  • mark_as_read

    Mark an email as read.

  • mark_as_unread

    Mark an email as unread.

  • remove_accountwrite action

    Remove a Gmail account and its stored credentials.

  • remove_labelwrite action

    Remove one or more labels from an email.

  • reply_to_emailwrite action

    Reply to an existing email, preserving thread context.

  • search_emails

    Search emails using Gmail search syntax (e.g. "from:foo is:unread").

  • send_emailwrite action

    Send an email from a Gmail account.

Public scan report

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

no findings
  • Code scan10 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 45 days ago12/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 78/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Multi Gmail compares

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

Safety score
78/100
higher than 62% of 916 Email servers
Tools
15
the typical Email server has 7
Tools that change things
47%
typical: 25%. Fewer write tools means less an agent can break
GitHub stars
19
more than 91% of 493 Email servers
Downloads a week
75
more than 51% of 235 Email servers with a package

What its tools let an agent do: 5 read · 2 create · 3 change · 3 delete · 2 send or post

Install Multi Gmail in Claude Code, Cursor or VS Code

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

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

What the publisher says

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

multi-gmail-mcp

A Model Context Protocol (MCP) server that lets Claude Desktop manage multiple Gmail accounts simultaneously. Listed on the official Anthropic MCP registry and published on npm.

Features

  • Connect unlimited Gmail accounts — personal, work, side projects
  • Search any inbox using full Gmail search syntax
  • Read complete emails with MIME parsing
  • Send, reply in thread, and create drafts
  • Organize with labels: add, remove, list, archive
  • Mark as read / unread
  • Tokens stored locally in ~/.gmail-mcp-tokens.db — never committed to git
  • Auto-refreshes OAuth tokens silently

Requirements

  • Node.js >= 22.5.0
  • A Google Cloud project with the Gmail API enabled
  • Claude Desktop

Installation

npm install -g multi-gmail-mcp

This registers two global commands: gmail-mcp (the MCP server) and gmail-mcp-cli (account manager).

Google Cloud Setup

You only need to do this once.

  1. Go to console.cloud.google.com → create a project
  2. Enable the Gmail API (APIs & Services → Library)
  3. Configure the OAuth consent screen — External, add your Gmail addresses as test users
  4. Add scopes: gmail.readonly, gmail.send, gmail.modify, gmail.labels
  5. Create a Desktop app OAuth credential → download the JSON
  6. Save it to ~/.gmail-mcp-oauth.json

Alternatively, set environment variables in the Claude Desktop config (see below).

Authenticating Gmail Accounts

# Add accounts (opens browser for Google sign-in)
gmail-mcp-cli add personal@gmail.com
gmail-mcp-cli add work@company.com

# List authenticated accounts
gmail-mcp-cli list

# Remove an account
gmail-mcp-cli remove work@company.com

Tokens are saved to ~/.gmail-mcp-tokens.db and refreshed automatically.

Claude Desktop Configuration

Edit ~/Library/Application Support/Claude/claudedesktopconfig.json:

{
  "mcpServers": {
    "multi-gmail": {
      "command": "gmail-mcp"
    }
  }
}

If you prefer environment variables over ~/.gmail-mcp-oauth.json:

{
  "mcpServers": {
    "multi-gmail": {
      "command": "gmail-mcp",
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id.apps.googleusercontent.com",
        "GOOGLE_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Restart Claude Desktop after saving. Click the hammer icon to confirm 19 tools are loaded.

Available Tools

Account Management

Reading Email

Writing Email

Organization

Example Prompts

List all my authenticated Gmail accounts.
Search my work@company.com inbox for unread emails from this week.
Reply to that email from my personal account saying I'll be there Saturday.

Shortened. The full README is on GitHub.

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

Multi Gmail: common questions

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

Alternatives to Multi Gmail

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

All Multi Gmail alternatives →
  • Google Workspace
    Give AI agents access to Gmail, Calendar, Drive, and more — multi-account, manifest-driven
    A
  • Imap
    IMAP/SMTP MCP server to search, read, organize, send, reply & forward email for AI assistants
    A
  • Fluxmail
    Read, search, draft, send, and organize email through Gmail, Outlook, and IMAP/SMTP mailboxes.
    B
  • Agent Email
    Local email connectivity for AI agents — read, draft, send, and organize Outlook mail via MCP
    A
  • Microsoft 365 Mail
    Microsoft 365 Outlook mail via Graph: read, search, send, reply, forward, draft, move, delete.
    A