Headless Gmail MCP Server

A simple Gmail MCP server (no authentication flow)

Node.jsstdio

context tax

pending

security

pending

cold start

pending

freshness

pending

Our reading of Headless Gmail, from the data

Headless Gmail is a browser automation MCP server.

We haven't measured its tool list yet, so its token cost is unknown.

It runs locally on your machine over stdio.

Install Headless Gmail MCP server

claude mcp add headless-gmail -- npx -y @peakmojo/mcp-server-headless-gmail

{
  "mcpServers": {
    "headless-gmail": {
      "command": "npx",
      "args": [
        "-y",
        "@peakmojo/mcp-server-headless-gmail"
      ]
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "headless-gmail": {
      "command": "npx",
      "args": [
        "-y",
        "@peakmojo/mcp-server-headless-gmail"
      ]
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "headless-gmail": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@peakmojo/mcp-server-headless-gmail"
      ]
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "headless-gmail": {
      "command": "npx",
      "args": [
        "-y",
        "@peakmojo/mcp-server-headless-gmail"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Freshness

Not enough public signals yet to judge maintenance.

Last commit (default branch)
no data · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
no data · official registry

How it compares in Browser Automation

Against the most-starred browser automation servers we index. Token cost is per model turn, measured from each server's live tool list.

Server	Stars	Tools	Tokens / turn	Freshness	Runs
Headless Gmail (this)	—	—	not measured	—	local
Browser Use	118,444	—	not measured	Active	local
Scrapling	88,517	—	not measured	Active	local
Browser	39,318	—	not measured	Active	local + hosted
Playwright	38,349	—	not measured	Active	local
Browser	36,690	—	not measured	Active	—

All browser automation MCP servers

FAQ

›How do I install the Headless Gmail MCP server in Claude Code?

Run: claude mcp add headless-gmail -- npx -y @peakmojo/mcp-server-headless-gmail. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Headless Gmail require an API key?

No required environment variables are declared in its published metadata.

›Can I use Headless Gmail as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Headless Gmail in the official MCP registry?

No. It was indexed from npm.

Sources and method

Package registry (npm / PyPI): listed
Last checked against all sources: 2026-10-19

The description, packages and links come from the maintainer's own published metadata. Token cost, security signals, freshness and the reading above are MCPSkillHub's own measurements; see the methodology. Spot an error? Request a correction or claim the listing.