Advertise
MCP.so
Sign In

Gmail Server for MCP Server

@MCP-Mirror

Repository

Basic information

Category

Communication

License

GPL-3.0 license

Transports

stdio

Author

MCP-Mirror

About Gmail Server for MCP Server

Mirror of

#gmail#mcp#email-server

Gmail Server for MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "jasonsum_gmail-mcp-server": {
      "command": "npx",
      "args": [
        "@modelcontextprotocol/inspector",
        "uv",
        "run",
        "[absolute-path-to-git-repo]/src/gmail/server.py",
        "--creds-file-path",
        "[absolute-path-to-credentials-file]",
        "--token-path",
        "[absolute-path-to-access-tokens-file]"
      ]
    }
  }
}

Gmail Server for MCP Server tools

6

Sends email to email address recipient

Moves email to trash

Marks email as read

Retrieves unread emails

Retrieves given email content

Open email in browser

Overview

What is Gmail Server for Model Context Protocol (MCP)?

This MCP server integrates with Gmail to enable sending, removing, reading, drafting, and responding to emails. The MCP client prompts the user before conducting such activities.

How to use Gmail Server for Model Context Protocol (MCP)?

First, set up a Google Cloud project, enable the Gmail API, configure an OAuth consent screen with test user, add OAuth scope https://www.googleapis.com/auth/gmail/modify, and create an OAuth Client ID for a Desktop App. Download the JSON credentials file and note its absolute path. Then configure an MCP client (e.g., Claude Desktop) using uv with parameters --creds-file-path and --token-path. On startup, a browser-based authentication flow saves token credentials to the specified token path.

Key features of Gmail Server for Model Context Protocol (MCP)

  • Send emails to a recipient with subject and content
  • Move emails to trash by ID
  • Mark emails as read by ID
  • Retrieve a list of unread emails
  • Fetch full content of a specific email (marks as read)
  • Open an email in the default browser by ID

Use cases of Gmail Server for Model Context Protocol (MCP)

  • An AI assistant sends an email on behalf of the user
  • Automatically trash or mark-as-read bulk messages
  • Read unread emails and summarize them for the user
  • Open a specific email in the browser for manual review

Frequently asked questions

1

What Gmail OAuth scopes are required?

The server uses `https://www.googleapis.com/auth/gmail.modify` which allows reading, sending, and modifying emails.

2

How is authentication handled?

On server start, a browser-based OAuth flow launches. Token credentials are saved to the file specified by `--token-path` and reused on subsequent runs.

3

What are the required dependencies?

A Google Cloud project with the Gmail API enabled, a Desktop App OAuth client, and `uv` for running the server. No Python dependencies beyond those bundled with the server are mentioned.

4

Where are credentials and tokens stored?

Credentials are stored in the file path given to `--creds-file-path`. Access and refresh tokens are stored in the file path given to `--token-path`. Both are local file paths on the user’s machine.

5

How is the server invoked?

The server is run via `uv run gmail --creds-file-path <path> --token-path <path>`. It communicates over stdio (standard MCP transport).

Comments

More Communication MCP servers

Faxify MCP

Const Agility, LLC

Send, receive and track real faxes in the US and Canada from Claude, ChatGPT or Cursor.

Canarics

Canarics

AI call analysis and voice agents for sales teams. This MCP server lets a team's own AI assistant read minute usage, agents, call summaries and daily stats, look up caller history, schedule consent-gated AI callbacks, an

Mektup-mcp

WeeCi

Mektup gives AI agents and their humans a real email mailbox, not just a one-way sending API. Through 41 MCP tools, an agent can register a domain, create a mailbox, send and receive mail, and manage threads, drafts, fol

B2B Creators

Social Tree Global

Agencies and GTM teams use HeyReach and Instantly to run LinkedIn outbound from personal sender profiles — but those profiles sit empty and prospects don't accept. B2B Creators is the content layer that keeps every sende

LinkedIn MCP Server: DMs, Inbox & Network for Claude, ChatGPT, Cursor

TalkToHumans

LinkedIn MCP server for Claude, ChatGPT, Cursor & Codex. Read LinkedIn DMs, search your network, enrich profiles and draft messages you review before sending.

1
Advertise