Gmail Server for Model Context Protocol (MCP)

Name: Gmail Server for Model Context Protocol (MCP)
Author: jasonsum

@jasonsum

Repository

About Gmail Server for Model Context Protocol (MCP)

Model Context Protocol (MCP) server for Gmail

Basic information

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

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.