An MCP (Model Context Protocol) server that provides Gmail integration capabilities to MCP clients like Claude Desktop.
gmail-mcp-server is an MCP project maintained in the ajbr0wn/gmail-mcp-server repository. The maintainer describes its purpose as “An MCP (Model Context Protocol) server that provides Gmail integration capabilities to MCP clients like Claude Desktop”. Read the project documentation for the complete scope.
The project provides a local client configuration using /path/to/conda/envs/mcp-gmail/bin/python. 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, GMAIL_CREDENTIALS_FILE, GMAIL_TOKEN_FILE. 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.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| search_emails | Description: Search Gmail emails with a query |
| Parameters: | query (required): Gmail search query (uses Gmail's standard search syntax) |
| max_results | optional): Maximum number of results to return (default: 10) |
{
"mcpServers": {
"gmail": {
"command": "/path/to/conda/envs/mcp-gmail/bin/python",
"args": [
"-m",
"gmail_mcp_server.server"
],
"env": {
"PYTHONPATH": "/path/to/gmail-mcp-server/src",
"GMAIL_CREDENTIALS_FILE": "YOUR_GMAIL_CREDENTIALS_FILE",
"GMAIL_TOKEN_FILE": "YOUR_GMAIL_TOKEN_FILE"
}
}
}
}From the project documentation. Replace placeholders and example paths before connecting.
| Variable | Description | Required |
|---|---|---|
| PYTHONPATH | Declared in the maintainer’s client configuration. | Check documentation |
| GMAIL_CREDENTIALS_FILE | Declared in the maintainer’s client configuration. | Yes |
| GMAIL_TOKEN_FILE | Declared in the maintainer’s client configuration. | Yes |
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.