MCP Headless Gmail MCP Server

A simple Gmail MCP server (no authentication flow)

Local serverstdioPython

What is the MCP Headless Gmail MCP server?

MCP Headless Gmail becomes available to MCP clients through the mcp headless gmail mcp server. A simple Gmail MCP server (no authentication flow).

What MCP Headless Gmail does

A MCP (Model Context Protocol) server that provides get, send Gmails without local credential or token setup.

Installing the mcp headless gmail mcp server

Setup follows the standard MCP pattern: clone or install the server, then register it in your client's configuration file and restart the client. The configuration snippets on this page cover Claude Desktop, Claude Code and Cursor.

Requirements

  • Python 3.10 or higher - Google API credentials (client ID, client secret, access token, and refresh token)

Where it fits

Communication servers earn their keep on volume — summarising channels and threads that would otherwise cost you an hour of scrollback. MCP Headless Gmail sits in that group. Worth comparing against the other communication servers in this directory before you commit to one, since several overlap in scope but differ sharply in setup cost and permissions.

Practical notes

  • This server runs locally, so it operates with whatever access your machine and its credentials already have. Scope that deliberately rather than by default.
  • Maintained by baryhuang, written in Python.
  • MCP clients ask for confirmation before each tool call by default. Keep that on while you learn what the mcp headless gmail mcp server actually does with your data.
  • Every entry in this directory is reviewed by hand before it goes live, and details are checked against the project's own documentation.

How to install the MCP Headless Gmail MCP server

npm version
```json
{
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": [
        "@peakmojo/mcp-server-headless-gmail"
      ]
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

  • Python 3.10 or higher - Google API credentials (client ID, client secret, access token, and refresh token)

Frequently asked questions

It connects MCP Headless Gmail to MCP-compatible AI assistants such as Claude and Cursor. Instead of copying data back and forth by hand, the assistant works with MCP Headless Gmail directly.