Skip to content
Kitbay
MCP server

mcp-headless-gmail

Runs locallyMITUpdated on May 24, 202555GitHub starsCan change dataNeeds an API key

A Python MCP server for Gmail built to run without a browser or local token files, for example inside Docker on a remote host.

What it does

A Python MCP server for Gmail built to run without a browser or local token files, for example inside Docker on a remote host. The server stores no credentials: the client completes Google's OAuth flow elsewhere and passes the client ID, secret, access token and refresh token in each tool call. Tools fetch recent emails with the first thousand characters of the body, read longer bodies in chunks, send email and refresh the access token. It ships as a Docker image and an npm package, with Claude Desktop examples for both.

Capabilities

  • Get recent emails
  • Read a full email body in chunks
  • Send an email
  • Refresh Google access tokens