Advertise
MCP.so
Sign In

Gmail Server for MCP Server

@jasonsum

Repository

Basic information

Category

Communication

Transports

stdio

Author

jasonsum

About Gmail Server for MCP Server

Model Context Protocol (MCP) server for Gmail

Gmail Server for MCP Server config

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

{
  "mcpServers": {
    "gmail-mcp-server-jasonsum": {
      "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. It requires user confirmation before executing any email actions.

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

Set up a Google Cloud project, enable the Gmail API, configure OAuth consent with the gmail.modify scope, and download OAuth credentials. Pass the credentials file path and a token storage path as --creds-file-path and --token-path when starting the server. Use uv to run with Claude Desktop or MCP Inspector.

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

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

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

  • Automatically send scheduled email reports via an AI assistant.
  • Let an LLM agent read and respond to support tickets.
  • Enable voice‑controlled email management.
  • Integrate email triage into a larger workflow automation.
  • Test and debug email actions using the MCP Inspector.

Frequently asked questions

1

What Gmail API permissions does this server require?

It uses the OAuth scope `https://www.googleapis.com/auth/gmail.modify`, which allows reading, sending, trashing, and marking emails.

2

How do I authenticate with Gmail?

On first run, the server launches a browser for OAuth consent. Tokens are then saved to the path specified by `--token-path` and reused on subsequent starts.

3

Can I use this server with Claude Desktop?

Yes. Add an `mcpServers` entry in your Claude Desktop config JSON. The command uses `uv` with parameters `--directory`, `--creds-file-path`, and `--token-path`.

4

How can I test the server before using it in production?

Use the MCP Inspector from the repository root: `npx @modelcontextprotocol/inspector uv run <path>/server.py --creds-file-path <path> --token-path <path>`.

5

Where are my credentials and tokens stored?

Both are stored locally in files you specify. The credentials file is the OAuth client JSON from Google Cloud; the token file is generated after authentication.

Comments

More Communication MCP servers

AgentCouch

Messaging rooms for AI agents: hand off context across tools, worktrees, machines, and teammates. Agents meet in shared rooms over MCP, hand off directly, and leave a replayable transcript; live sessions wake on reply, b

Mobile Text Alerts SMS

Mobile Text Alerts

Official Mobile Text Alerts server. Send and schedule SMS, manage subscribers and groups, and complete carrier registration from any MCP-compatible AI assistant.

Socialync

Jack Vitick

Draft, schedule, and publish social media posts to 8 platforms from any AI agent: Facebook, Instagram, X, TikTok, YouTube, LinkedIn, Threads, and Bluesky. 19 tools covering drafting, scheduling, publishing, media upload,

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.

Caulo

Patry

Caulo is the social layer of the agentic web: a social network your AI agent reads, briefs you on, and posts to — by prompt. Ad-free, verified humans only, with provenance on every post (human / agent-assisted / agent-au

Advertise