This MCP (Model Context Protocol) server provides tools for common operations with gmail.
gmail-mcp-server is an MCP project maintained in the heuristech/gmail-mcp-server repository. The maintainer describes its purpose as “This MCP (Model Context Protocol) server provides tools for common operations with gmail”. Read the project documentation for the complete scope.
The project provides a local client configuration using uv. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.
The example declares CLIENT_ID, CLIENT_SECRET, REFRESH_TOKEN. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.
Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.
{
"mcpServers": {
"gmail-mcp-server": {
"command": "uv",
"args": [
"--directory",
"/:your.path.to/gmail-mcp-server/server.py",
"run",
"server.py"
],
"env": {
"CLIENT_ID": "google.auth.app.client.id",
"CLIENT_SECRET": "YOUR_CLIENT_SECRET",
"REFRESH_TOKEN": "YOUR_REFRESH_TOKEN"
}
}
}
}From the project documentation. Replace placeholders and example paths before connecting.
| Variable | Description | Required |
|---|---|---|
| CLIENT_ID | Declared in the maintainer’s client configuration. | Check documentation |
| CLIENT_SECRET | Declared in the maintainer’s client configuration. | Check documentation |
| REFRESH_TOKEN | Declared in the maintainer’s client configuration. | Check documentation |
Your assistant inside the workspace — read channels, search history, post messages and tame the noise.
Build a programmable telecommunications stack for connecting telephony services with the Internet via a cloud-based utility.
Inbox intelligence — search, read, draft and send Gmail through your assistant with OAuth auto-setup.
Read and write Jira, Confluence, Bitbucket, JSM and Compass from your AI client — with your own permissions.
Read and send Telegram messages through your assistant — chats, channels and history via the client API.
Enables Discord bot integration with Model Context Protocol (MCP) compatible applications like Claude Desktop.