MCP.so
Sign In

Gmail Server for Model Context Protocol (MCP)

@jasonsum

Repository

About Gmail Server for Model Context Protocol (MCP)

Model Context Protocol (MCP) server for Gmail

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]"
      ]
    }
  }
}

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.

FAQ from Gmail Server for Model Context Protocol (MCP)

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.

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.

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.

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>.

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.

Frequently asked questions

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.

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.

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`.

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>`.

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

Basic information

Category

Communication

Transports

stdio

Author

jasonsum

More Communication MCP servers

飞书MCP服务器

sdd330

MCP server provides feishu related operations

54

Outlook MCP Server

Wallisking1991

58

Mattermost MCP Server

pvev

Mattermost MCP server to enable Claude to interact with Mattermost Workspaces

39

MCP Teams Server

InditexTech

An MCP (Model Context Protocol) server implementation for Microsoft Teams integration, providing capabilities to read messages, create messages, reply to messages, mention members.

383

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