Gmail MCP
Rank #26,613io.github.A1-x-Tech/mcp-google-gmail
MCP server for the Gmail API: search, read and send email, manage drafts, labels and the trash.
Gmail MCP is a Model Context Protocol (MCP) server published by A1-x-Tech. It ranks #26,613 of 115,460 servers tracked on MCP Toplist. Gmail MCP is listed on Official MCP, with 1 tracked version. It was first listed on Aug 30, 2026 and most recently updated on Aug 30, 2026.
Ranks ahead of 88,847 of 115,460 servers on MCP Toplist.
Use Gmail MCP
No credentials or required configuration declared — add it to your MCP client and go.
claude mcp add mcp-google-gmail -e "GOOGLE_GMAIL_CLIENT_ID=<your GOOGLE_GMAIL_CLIENT_ID>" -e "GOOGLE_GMAIL_CLIENT_SECRET=<your GOOGLE_GMAIL_CLIENT_SECRET>" -e "GOOGLE_GMAIL_REFRESH_TOKEN=<your GOOGLE_GMAIL_REFRESH_TOKEN>" -e "GOOGLE_GMAIL_ACCESS_TOKEN=<your GOOGLE_GMAIL_ACCESS_TOKEN>" -e "GOOGLE_GMAIL_API_BASE=<your GOOGLE_GMAIL_API_BASE>" -e "GOOGLE_GMAIL_TIMEOUT_MS=<your GOOGLE_GMAIL_TIMEOUT_MS>" -e "GOOGLE_GMAIL_MAX_RETRIES=<your GOOGLE_GMAIL_MAX_RETRIES>" -- npx -y mcp-google-gmailReplace each placeholder with your own value before saving.
[mcp_servers.mcp-google-gmail]
command = "npx"
args = ["-y", "mcp-google-gmail"]
[mcp_servers.mcp-google-gmail.env]
GOOGLE_GMAIL_CLIENT_ID = "<your GOOGLE_GMAIL_CLIENT_ID>"
GOOGLE_GMAIL_CLIENT_SECRET = "<your GOOGLE_GMAIL_CLIENT_SECRET>"
GOOGLE_GMAIL_REFRESH_TOKEN = "<your GOOGLE_GMAIL_REFRESH_TOKEN>"
GOOGLE_GMAIL_ACCESS_TOKEN = "<your GOOGLE_GMAIL_ACCESS_TOKEN>"
GOOGLE_GMAIL_API_BASE = "<your GOOGLE_GMAIL_API_BASE>"
GOOGLE_GMAIL_TIMEOUT_MS = "<your GOOGLE_GMAIL_TIMEOUT_MS>"
GOOGLE_GMAIL_MAX_RETRIES = "<your GOOGLE_GMAIL_MAX_RETRIES>"Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"mcp-google-gmail": {
"command": "npx",
"args": [
"-y",
"mcp-google-gmail"
],
"env": {
"GOOGLE_GMAIL_CLIENT_ID": "<your GOOGLE_GMAIL_CLIENT_ID>",
"GOOGLE_GMAIL_CLIENT_SECRET": "<your GOOGLE_GMAIL_CLIENT_SECRET>",
"GOOGLE_GMAIL_REFRESH_TOKEN": "<your GOOGLE_GMAIL_REFRESH_TOKEN>",
"GOOGLE_GMAIL_ACCESS_TOKEN": "<your GOOGLE_GMAIL_ACCESS_TOKEN>",
"GOOGLE_GMAIL_API_BASE": "<your GOOGLE_GMAIL_API_BASE>",
"GOOGLE_GMAIL_TIMEOUT_MS": "<your GOOGLE_GMAIL_TIMEOUT_MS>",
"GOOGLE_GMAIL_MAX_RETRIES": "<your GOOGLE_GMAIL_MAX_RETRIES>"
}
}
}
}Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.
{
"mcpServers": {
"mcp-google-gmail": {
"command": "npx",
"args": [
"-y",
"mcp-google-gmail"
],
"env": {
"GOOGLE_GMAIL_CLIENT_ID": "<your GOOGLE_GMAIL_CLIENT_ID>",
"GOOGLE_GMAIL_CLIENT_SECRET": "<your GOOGLE_GMAIL_CLIENT_SECRET>",
"GOOGLE_GMAIL_REFRESH_TOKEN": "<your GOOGLE_GMAIL_REFRESH_TOKEN>",
"GOOGLE_GMAIL_ACCESS_TOKEN": "<your GOOGLE_GMAIL_ACCESS_TOKEN>",
"GOOGLE_GMAIL_API_BASE": "<your GOOGLE_GMAIL_API_BASE>",
"GOOGLE_GMAIL_TIMEOUT_MS": "<your GOOGLE_GMAIL_TIMEOUT_MS>",
"GOOGLE_GMAIL_MAX_RETRIES": "<your GOOGLE_GMAIL_MAX_RETRIES>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.
{
"servers": {
"mcp-google-gmail": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-google-gmail"
],
"env": {
"GOOGLE_GMAIL_CLIENT_ID": "<your GOOGLE_GMAIL_CLIENT_ID>",
"GOOGLE_GMAIL_CLIENT_SECRET": "<your GOOGLE_GMAIL_CLIENT_SECRET>",
"GOOGLE_GMAIL_REFRESH_TOKEN": "<your GOOGLE_GMAIL_REFRESH_TOKEN>",
"GOOGLE_GMAIL_ACCESS_TOKEN": "<your GOOGLE_GMAIL_ACCESS_TOKEN>",
"GOOGLE_GMAIL_API_BASE": "<your GOOGLE_GMAIL_API_BASE>",
"GOOGLE_GMAIL_TIMEOUT_MS": "<your GOOGLE_GMAIL_TIMEOUT_MS>",
"GOOGLE_GMAIL_MAX_RETRIES": "<your GOOGLE_GMAIL_MAX_RETRIES>"
}
}
}
}Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"mcp-google-gmail": {
"command": "npx",
"args": [
"-y",
"mcp-google-gmail"
],
"env": {
"GOOGLE_GMAIL_CLIENT_ID": "<your GOOGLE_GMAIL_CLIENT_ID>",
"GOOGLE_GMAIL_CLIENT_SECRET": "<your GOOGLE_GMAIL_CLIENT_SECRET>",
"GOOGLE_GMAIL_REFRESH_TOKEN": "<your GOOGLE_GMAIL_REFRESH_TOKEN>",
"GOOGLE_GMAIL_ACCESS_TOKEN": "<your GOOGLE_GMAIL_ACCESS_TOKEN>",
"GOOGLE_GMAIL_API_BASE": "<your GOOGLE_GMAIL_API_BASE>",
"GOOGLE_GMAIL_TIMEOUT_MS": "<your GOOGLE_GMAIL_TIMEOUT_MS>",
"GOOGLE_GMAIL_MAX_RETRIES": "<your GOOGLE_GMAIL_MAX_RETRIES>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"mcp-google-gmail": {
"command": "npx",
"args": [
"-y",
"mcp-google-gmail"
],
"env": {
"GOOGLE_GMAIL_CLIENT_ID": "<your GOOGLE_GMAIL_CLIENT_ID>",
"GOOGLE_GMAIL_CLIENT_SECRET": "<your GOOGLE_GMAIL_CLIENT_SECRET>",
"GOOGLE_GMAIL_REFRESH_TOKEN": "<your GOOGLE_GMAIL_REFRESH_TOKEN>",
"GOOGLE_GMAIL_ACCESS_TOKEN": "<your GOOGLE_GMAIL_ACCESS_TOKEN>",
"GOOGLE_GMAIL_API_BASE": "<your GOOGLE_GMAIL_API_BASE>",
"GOOGLE_GMAIL_TIMEOUT_MS": "<your GOOGLE_GMAIL_TIMEOUT_MS>",
"GOOGLE_GMAIL_MAX_RETRIES": "<your GOOGLE_GMAIL_MAX_RETRIES>"
}
}
}
}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.A1-x-Tech%2Fmcp-google-gmail)<a href="https://mcptoplist.com/server/io.github.A1-x-Tech%2Fmcp-google-gmail"><img src="https://mcptoplist.com/badge/io.github.A1-x-Tech%2Fmcp-google-gmail.svg" alt="MCP Toplist: Top 25% of 115,460" /></a>Variants: append ?metric=score or ?metric=stars to the image URL.
Listed on 1 registry
A1-x-Tech
Other servers by A1-x-Tech
- Yandex Merchants MCP#8,719 · 4 vers
- Yandex Audience MCP#8,997 · 4 vers
- Yandex Delivery MCP#9,185 · 4 vers
- Google Tag Manager MCP#10,278 · 4 vers
- Google Forms MCP#10,534 · 4 vers
- Google Merchant Center MCP#10,535 · 4 vers
- Google Business Profile MCP#10,670 · 4 vers
- Google CrUX MCP#10,671 · 4 vers
- Yango Delivery MCP#10,819 · 4 vers
- Yango Tech Retail MCP#10,820 · 4 vers
- Google Search Console MCP#10,973 · 4 vers
- Avito Ads MCP#12,271 · 3 vers
Available versions (1)
| Version | Published |
|---|---|
| 0.1.0 | Aug 30, 2026 |
Frequently asked questions
- Who maintains Gmail MCP?
- Gmail MCP is maintained by A1-x-Tech, which publishes 24 MCP servers (59 total versions) tracked on MCP Toplist.
- Is Gmail MCP listed on the Official MCP Registry?
- Yes — Gmail MCP is listed on the Official MCP Registry.
- How many versions does Gmail MCP have?
- MCP Toplist tracks 1 version of Gmail MCP, most recently published on Aug 30, 2026.
- Where can I find the source code for Gmail MCP?
- The source code for Gmail MCP is hosted at github.com/A1-x-Tech/mcp-google-gmail.