A Model Context Protocol (MCP) server for Gmail & Google Calendar integration with Claude Desktop, enabling intelligent, context-aware interactions with your email.
gmail-mcp is an MCP project maintained in the bastienchabal/gmail-mcp repository. The maintainer describes its purpose as “A Model Context Protocol (MCP) server for Gmail & Google Calendar integration with Claude Desktop, enabling intelligent, context-aware interactions with your email”. Read the project documentation for the complete scope.
The project provides a local client configuration using /<absolute-path>/gmail-mcp/.venv/bin/mcp. 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 PYTHONPATH, CONFIG_FILE_PATH, GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, TOKEN_ENCRYPTION_KEY. 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": {
"command": "/<absolute-path>/gmail-mcp/.venv/bin/mcp",
"args": [
"run",
"/<absolute-path>/gmail-mcp/gmail_mcp/main.py:mcp"
],
"cwd": "/<absolute-path>/gmail-mcp",
"env": {
"PYTHONPATH": "/<absolute-path>/gmail-mcp",
"CONFIG_FILE_PATH": "/<absolute-path>/gmail-mcp/config.yaml",
"GOOGLE_CLIENT_ID": "<your-client-id>",
"GOOGLE_CLIENT_SECRET": "YOUR_GOOGLE_CLIENT_SECRET",
"TOKEN_ENCRYPTION_KEY": "YOUR_TOKEN_ENCRYPTION_KEY"
}
}
}
}From the project documentation. Replace placeholders and example paths before connecting.
| Variable | Description | Required |
|---|---|---|
| PYTHONPATH | Declared in the maintainer’s client configuration. | Check documentation |
| CONFIG_FILE_PATH | Declared in the maintainer’s client configuration. | Check documentation |
| GOOGLE_CLIENT_ID | Declared in the maintainer’s client configuration. | Check documentation |
| GOOGLE_CLIENT_SECRET | Declared in the maintainer’s client configuration. | Check documentation |
| TOKEN_ENCRYPTION_KEY | 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.