mcp-headless-gmail
mcp-headless-gmail is an MCP server, listed under communication. It reaches gmail. Its repository has 55 GitHub stars and is licensed under MIT; we last read it on 2026-10-22.
This software acts as an MCP server to retrieve and send emails through Gmail without requiring local credential or token setup.
Install
MCP servers are packaged differently from each other -- some run via npx, some as a Docker image, some as a plain script you clone and run. mcp-headless-gmail’s own README did not state one plainly enough for this page to quote it rather than guess, so it will not guess. The repository below states it.
What it reaches, and what it needs
Maintenance
A MCP (Model Context Protocol) server that provides get, send Gmails without local credential or token setup.
What mcp-headless-gmail can do
2 tools documented in its README. An AI client calls these by name.
gmail_refresh_token- Refresh access tokens separately
get_recent_emails- Retrieves recent emails with the first 1k characters of each email body
Read from the README; names are kept only if the README contains them.
mcp-headless-gmail compared with similar servers
| Server | Reaches | Needs | Stars | Last update | Licence |
|---|---|---|---|---|---|
| mcp-headless-gmail (this page) | gmail | None listed | 55 | 2025-05-24 | MIT |
| google-workspace-mcp | gmail, google(1 shared) | GOOGLE_CLIENT_SECRET | 192 | 2026-10-21 | Apache-2.0 |
| mail-mcp | gmail, mail(1 shared) | MAIL_OAUTH2_DEFAULT_CLIENT_SECRET, MAIL_OAUTH2_DEFAULT_REFRESH_TOKEN, MAIL_OAUTH2_WORK_CLIENT_SECRET, MAIL_OAUTH2_WORK_REFRESH_TOKEN | 108 | 2026-10-23 | MIT |
| mcp-server-email | gmail(1 shared) | None listed | 81 | 2025-04-27 | MIT |
| mail-use | gmail(1 shared) | None listed | 47 | 2026-10-13 | MIT |
| google-workspace-mcp-server | gmail, google(1 shared) | GOOGLE_CLIENT_SECRET, GOOGLE_REFRESH_TOKEN | 31 | 2024-12-29 | MIT |
Ranked by services in common with mcp-headless-gmail, then by stars. Figures are from each repository when we last read it.
Common questions about mcp-headless-gmail
- What does mcp-headless-gmail do?
- This software acts as an MCP server to retrieve and send emails through Gmail without requiring local credential or token setup.
- How do I install mcp-headless-gmail?
- Its README did not state an install command plainly enough for us to quote one, so we do not guess. The repository has the instructions: https://github.com/baryhuang/mcp-headless-gmail
- What does mcp-headless-gmail connect to, and what does it need?
- It reaches gmail.
- Is mcp-headless-gmail official and is it maintained?
- We found nothing naming it as a vendor’s official server. Its repository has 55 GitHub stars and its state in our directory is stale. Its last commit we recorded was on 2025-05-24.
- What licence does mcp-headless-gmail use?
- The repository declares the MIT licence.
More MCP servers for communication
- line-bot-mcp-server789 stars
- graphlit-mcp-server377 stars
- mcp-email-server368 stars
- telegram-mcp349 stars
- human-in-the-loop230 stars
- google-workspace-mcp192 stars