MCP Headless Gmail Server (NPM & Docker)

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

Installation

# Clone the repository
git clone https://github.com/baryhuang/mcp-headless-gmail.git
cd mcp-headless-gmail

# Install dependencies
pip install -e .

Usage

Start the server with: mcp-server-headless-gmail

Use MCP client like Claude with configuration:

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

Features include getting recent emails, full email body content, sending emails, and automatic token refresh.