How do I install Multi Gmail?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Multi Gmail need an API key?

The publisher lists these environment variables: GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET.

What transport does Multi Gmail use?

Multi Gmail runs locally over stdio.

When was Multi Gmail last checked?

Last checked 2026-11-09. Manage multiple Gmail accounts in Claude Desktop — search, send, reply, draft, and organize.

Multi Gmail MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Credentials from the publisher

GOOGLE_CLIENT_ID — Google OAuth2 client ID from your Google Cloud project (alternative to ~/.gmail-mcp-oauth.json)
GOOGLE_CLIENT_SECRET — Google OAuth2 client secret from your Google Cloud project (alternative to ~/.gmail-mcp-oauth.json)

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1GOOGLE_CLIENT_ID=<value> GOOGLE_CLIENT_SECRET=<secret> claude mcp add io.github.gx-55-multi-gmail-mcp -- npx -y multi-gmail-mcp@1.0.1

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.gx-55-multi-gmail-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ],9      "env": {10        "GOOGLE_CLIENT_ID": "<value>",11        "GOOGLE_CLIENT_SECRET": "<secret>"12      }13    }14  }15}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 1.0.1

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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.

demo

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.

Go to console.cloud.google.com → create a project
Enable the Gmail API (APIs & Services → Library)
Configure the OAuth consent screen — External, add your Gmail addresses as test users
Add scopes: gmail.readonly, gmail.send, gmail.modify, gmail.labels
Create a Desktop app OAuth credential → download the JSON
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 [email protected]
gmail-mcp-cli add [email protected]

# List authenticated accounts
gmail-mcp-cli list

# Remove an account
gmail-mcp-cli remove [email protected]

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

Claude Desktop Configuration

Edit ~/Library/Application Support/Claude/claude_desktop_config.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

Tool	Description
`list_accounts`	List all authenticated Gmail accounts
`initiate_auth`	Start OAuth flow — returns a URL to open in browser
`complete_auth`	Finalize auth after completing Google sign-in
`remove_account`	Remove an account and its stored credentials

Reading Email

Tool	Description
`search_emails`	Search with Gmail syntax (`is:unread`, `from:`, `after:`, etc.)
`get_email`	Fetch full email content by message ID

Writing Email

Tool	Description
`send_email`	Send an email (supports To, CC, BCC)
`reply_to_email`	Reply in thread, preserving References headers
`create_draft`	Save an email as a draft

Organization

Tool	Description
`list_labels`	List all Gmail labels for an account
`add_label`	Add one or more labels to a message
`remove_label`	Remove one or more labels from a message
`archive_email`	Remove from Inbox
`mark_as_read`	Remove the UNREAD label
`mark_as_unread`	Add the UNREAD label

Example Prompts

List all my authenticated Gmail accounts.

Search my [email protected] inbox for unread emails from this week.

Reply to that email from my personal account saying I'll be there Saturday.

Send an email from [email protected] to [email protected]
with subject "Dinner plans" and body "Are you free Saturday?"

Archive everything older than a week in my side-project inbox that's already read.

Check both my accounts for emails from GitHub and summarize them.

Security

~/.gmail-mcp-oauth.json and ~/.gmail-mcp-tokens.db live in your home directory — outside the project, never committed
.gitignore excludes *.db, .gmail-mcp-oauth.json, and .env
The server runs over stdio only — no network port is opened
OAuth scopes are limited to the minimum required

See SECURITY.md for full details: token storage, network behavior, scope rationale, revocation steps, and how to report a vulnerability.

Registry

Listed on the official Anthropic MCP registry:

io.github.gx-55/multi-gmail-mcp

curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.gx-55"

Project Structure

multi-gmail-mcp/
├── bin/
│   ├── gmail-mcp.js        # Entry point for the MCP server command
│   └── gmail-mcp-cli.js    # Entry point for the CLI command
├── src/
│   ├── server.js           # MCP server — all 19 tools
│   ├── gmail-client.js     # Gmail API wrapper
│   ├── auth.js             # OAuth2 flow with auto-refresh
│   ├── db.js               # SQLite token storage (node:sqlite)
│   └── cli.js              # Account management CLI
└── package.json

Troubleshooting

"No OAuth credentials found" Make sure ~/.gmail-mcp-oauth.json exists or set GOOGLE_CLIENT_ID / GOOGLE_CLIENT_SECRET in the Claude Desktop config.

"Account not found. Authenticate it first" Run gmail-mcp-cli add [email protected] before using that account in Claude.

Tools not appearing in Claude Desktop Confirm gmail-mcp is in your PATH (which gmail-mcp) and restart Claude Desktop.

Token expired errors Tokens auto-refresh if a valid refresh token is stored. If refresh fails, remove the account and re-authenticate: gmail-mcp-cli remove [email protected] && gmail-mcp-cli add [email protected].

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Multi Gmail?

Does Multi Gmail need an API key?

What transport does Multi Gmail use?

When was Multi Gmail last checked?

Documentation

multi-gmail-mcp

Features

Requirements

Installation

Google Cloud Setup

Authenticating Gmail Accounts

Claude Desktop Configuration

Available Tools

Account Management

Reading Email

Writing Email

Organization

Example Prompts

Security

Registry

Project Structure

Troubleshooting