mcp-headless-gmail
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
About
- Publisher
- baryhuang
- Tool
- Gmail
Works with
Install
MCP servers and skills can run code on your computer and act on your data. Review the source before installing.
Details
| Fact | Value | Source |
|---|---|---|
| Type | MCP server | |
| Tool | Gmail | |
| Publisher | baryhuang | source |
| Official status | Community (not published by the tool's vendor) | source |
| Connection | Local (runs on your computer) | source |
| Can change data | Yes | source |
| Needs an API key or sign-in | Yes | source |
| Platforms | Not stated in its documentation | |
| AI clients | Claude Desktop | source |
| Licence | MIT | source |
| Pricing | Not stated in its documentation | |
| Activity | Last commit May 24, 202555 GitHub starsDownload data not available (not on npm or PyPI) | source |
| Links | Repository |
More from baryhuang
2 servers
All 2 from baryhuang →Sources
- GitHub repositorygithub.com/baryhuang/mcp-headless-gmail · Backs: AI clients, Can change data, Connection, Needs an API key or sign-in, Official status, Publisher, Activity, LicenceNov 11, 2026
- Licence file (LICENSE)github.com/baryhuang/mcp-headless-gmail · Backs: LicenceNov 12, 2026
- GitHub API recordgithub.com/baryhuang/mcp-headless-gmailNov 10, 2026