MCP server
gmail-mcp
Runs locallyGPL-3.0Updated on Sep 30, 202623GitHub starsCan change dataNeeds an API key
A Python MCP server for Gmail that runs locally and signs in through a Google OAuth desktop client.
What it does
A Python MCP server for Gmail that runs locally and signs in through a Google OAuth desktop client. Beyond sending, reading, trashing and marking mail, it handles drafts (create, list, edit), creates, renames and deletes labels, treats labels as folders for moving mail, searches with Gmail query syntax, manages filters, and archives or restores messages one at a time or in batches. The README shows a Claude Desktop setup that runs it with uv and passes the paths of the credentials and token files.
Capabilities
- Send, read and trash emails
- Create, list and edit drafts
- Create, rename and delete labels
- Create and delete email filters
- Archive and restore emails in batches
About
- Publisher
- theposch
- 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 | theposch | 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 | GPL-3.0 | source |
| Pricing | Not stated in its documentation | |
| Activity | Last commit Sep 30, 202623 GitHub starsDownload data not available (not on npm or PyPI) | source |
| Links | Repository |
Sources
- GitHub repositorygithub.com/theposch/gmail-mcp · 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/theposch/gmail-mcp · Backs: LicenceNov 12, 2026
- GitHub API recordgithub.com/theposch/gmail-mcpNov 10, 2026