How do I install the mcp headless gmail mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

SSyncDev

Start a project

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

Requirements

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

Practical notes

Maintained by baryhuang, written in Python.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the MCP Headless Gmail MCP Server

{
  "mcpServers": {
    "gmail": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "buryhuang/mcp-headless-gmail:latest"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

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

Frequently asked questions

A simple Gmail MCP server (no authentication flow) Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.