Description

MCP Headless Gmail Server provides a way to access Gmail functionality without requiring local credential setup or browser access. Built by baryhuang, it enables any client to complete the OAuth flow independently and then pass credentials as context to the server, creating a complete separation between credential storage and implementation. The server supports getting recent emails, sending messages, and handling token refresh operations through a clean API that works in containerized environments. This implementation is particularly valuable for headless or remote applications where traditional Gmail access methods requiring local file access or browser interaction are not feasible.

🔬 Playground

Try Headless Gmail live in the browser with security context.

Unverified
No automated security scan has been run on this server yet.

Installation

git clone https://github.com/baryhuang/mcp-headless-gmail

Claude Desktop Configuration

Add this configuration to your Claude Desktop config file to enable this MCP server:

Config file location: ~/Library/Application Support/Claude/claude_desktop_config.json

Config file location: %APPDATA%\Claude\claude_desktop_config.json

Config file location: ~/.config/Claude/claude_desktop_config.json

claude_desktop_config.json
{
  "mcpServers": {
    "headless-gmail": {
      "command": "node",
      "args": [
        "path/to/server.js"
      ]
    }
  }
}

Community Reviews

Authenticated reviews from GitHub users. No anonymous submissions. Your experience helps others choose wisely.

0 reviews
5
0
4
0
3
0
2
0
1
0

No reviews yet. Be the first to share your experience.