Gmail
Rank #3,782io.github.domdomegg/gmail-mcp
Allow AI systems to read, send, archive, and manage emails via Gmail.
Gmail is a Model Context Protocol (MCP) server published by domdomegg. It ranks #3,782 of 115,460 servers tracked on MCP Toplist, and its repository has 11 GitHub stars. Gmail is listed across 3 registries — Official MCP, PulseMCP and Glama, with 12 tracked versions. It was first listed on Dec 10, 2025 and most recently updated on Jul 27, 2026.
Ranks ahead of 111,678 of 115,460 servers on MCP Toplist.
Use Gmail
Requires user-supplied configuration before first use — typically an API key, token or connection string set via environment variables.
claude mcp add gmail-mcp -e "GOOGLE_ACCESS_TOKEN=<your GOOGLE_ACCESS_TOKEN>" -- npx -y gmail-mcpReplace each placeholder with your own value before saving.
claude mcp add gmail-mcp -e "MCP_TRANSPORT=<your MCP_TRANSPORT>" -e "GOOGLE_CLIENT_ID=<your GOOGLE_CLIENT_ID>" -e "GOOGLE_CLIENT_SECRET=<your GOOGLE_CLIENT_SECRET>" -- npx -y gmail-mcpReplace each placeholder with your own value before saving.
[mcp_servers.gmail-mcp]
command = "npx"
args = ["-y", "gmail-mcp"]
[mcp_servers.gmail-mcp.env]
GOOGLE_ACCESS_TOKEN = "<your GOOGLE_ACCESS_TOKEN>"Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.
[mcp_servers.gmail-mcp]
command = "npx"
args = ["-y", "gmail-mcp"]
[mcp_servers.gmail-mcp.env]
MCP_TRANSPORT = "<your MCP_TRANSPORT>"
GOOGLE_CLIENT_ID = "<your GOOGLE_CLIENT_ID>"
GOOGLE_CLIENT_SECRET = "<your GOOGLE_CLIENT_SECRET>"Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"gmail-mcp": {
"command": "npx",
"args": [
"-y",
"gmail-mcp"
],
"env": {
"GOOGLE_ACCESS_TOKEN": "<your GOOGLE_ACCESS_TOKEN>"
}
}
}
}Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.
{
"mcpServers": {
"gmail-mcp": {
"command": "npx",
"args": [
"-y",
"gmail-mcp"
],
"env": {
"MCP_TRANSPORT": "<your MCP_TRANSPORT>",
"GOOGLE_CLIENT_ID": "<your GOOGLE_CLIENT_ID>",
"GOOGLE_CLIENT_SECRET": "<your GOOGLE_CLIENT_SECRET>"
}
}
}
}Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.
{
"mcpServers": {
"gmail-mcp": {
"command": "npx",
"args": [
"-y",
"gmail-mcp"
],
"env": {
"GOOGLE_ACCESS_TOKEN": "<your GOOGLE_ACCESS_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.
{
"mcpServers": {
"gmail-mcp": {
"command": "npx",
"args": [
"-y",
"gmail-mcp"
],
"env": {
"MCP_TRANSPORT": "<your MCP_TRANSPORT>",
"GOOGLE_CLIENT_ID": "<your GOOGLE_CLIENT_ID>",
"GOOGLE_CLIENT_SECRET": "<your GOOGLE_CLIENT_SECRET>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.
{
"servers": {
"gmail-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"gmail-mcp"
],
"env": {
"GOOGLE_ACCESS_TOKEN": "<your GOOGLE_ACCESS_TOKEN>"
}
}
}
}Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.
{
"servers": {
"gmail-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"gmail-mcp"
],
"env": {
"MCP_TRANSPORT": "<your MCP_TRANSPORT>",
"GOOGLE_CLIENT_ID": "<your GOOGLE_CLIENT_ID>",
"GOOGLE_CLIENT_SECRET": "<your GOOGLE_CLIENT_SECRET>"
}
}
}
}Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"gmail-mcp": {
"command": "npx",
"args": [
"-y",
"gmail-mcp"
],
"env": {
"GOOGLE_ACCESS_TOKEN": "<your GOOGLE_ACCESS_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"gmail-mcp": {
"command": "npx",
"args": [
"-y",
"gmail-mcp"
],
"env": {
"MCP_TRANSPORT": "<your MCP_TRANSPORT>",
"GOOGLE_CLIENT_ID": "<your GOOGLE_CLIENT_ID>",
"GOOGLE_CLIENT_SECRET": "<your GOOGLE_CLIENT_SECRET>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"gmail-mcp": {
"command": "npx",
"args": [
"-y",
"gmail-mcp"
],
"env": {
"GOOGLE_ACCESS_TOKEN": "<your GOOGLE_ACCESS_TOKEN>"
}
}
}
}Replace each placeholder with your own value before saving.
{
"mcpServers": {
"gmail-mcp": {
"command": "npx",
"args": [
"-y",
"gmail-mcp"
],
"env": {
"MCP_TRANSPORT": "<your MCP_TRANSPORT>",
"GOOGLE_CLIENT_ID": "<your GOOGLE_CLIENT_ID>",
"GOOGLE_CLIENT_SECRET": "<your GOOGLE_CLIENT_SECRET>"
}
}
}
}Replace each placeholder with your own value before saving.
Show your rank
Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.
[](https://mcptoplist.com/server/io.github.domdomegg%2Fgmail-mcp)<a href="https://mcptoplist.com/server/io.github.domdomegg%2Fgmail-mcp"><img src="https://mcptoplist.com/badge/io.github.domdomegg%2Fgmail-mcp.svg" alt="MCP Toplist: Top 5% of 115,460" /></a>Variants: append ?metric=score or ?metric=stars to the image URL.
Listed on 1 registry (2 delisted)
domdomegg
Other servers by domdomegg
- Airtable#776 · 10 vers
- Computer Use#1,592 · 13 vers
- Google Contacts#6,481 · 9 vers
- Openfoodfacts MCP#6,538 · 14 vers
- Defuddle Fetch MCP Server#6,696 · 4 vers
- Starling Bank#7,051 · 7 vers
- Google Drive MCP#7,212 · 7 vers
- Shell Exec#7,566 · 6 vers
- Filesystem MCP#10,801 · 6 vers
- Google Documents MCP#11,959 · 7 vers
- Google Sheets MCP#11,960 · 7 vers
- Downdetector MCP#12,811 · 2 vers
Available versions (12)
| Version | Published |
|---|---|
| 2.4.0 | Jul 27, 2026 |
| 2.3.2 | Jul 23, 2026 |
| 2.3.0 | Mar 7, 2026 |
| 2.2.1 | Feb 23, 2026 |
| 2.2.0 | Feb 21, 2026 |
| 2.1.2 | Dec 28, 2025 |
| 2.1.1 | Dec 28, 2025 |
| 2.1.0 | Dec 28, 2025 |
| 2.0.1 | Dec 13, 2025 |
| 2.0.0 | Dec 11, 2025 |
| 1.0.3 | Dec 10, 2025 |
| 0.1.0 | Nov 25, 2024 |
Frequently asked questions
- Who maintains Gmail?
- Gmail is maintained by domdomegg, which publishes 18 MCP servers (125 total versions) tracked on MCP Toplist.
- Is Gmail listed on the Official MCP Registry?
- Yes — Gmail is listed on the Official MCP Registry, alongside PulseMCP and Glama.
- How many versions does Gmail have?
- MCP Toplist tracks 12 versions of Gmail, most recently published on Jul 27, 2026.
- Where can I find the source code for Gmail?
- The source code for Gmail is hosted at github.com/domdomegg/gmail-mcp.git.