gmail-agent
Rank #15,243io.github.dremok/gmail-agent
Gmail for AI agents: search, read, download attachments, send, reply, drafts, labels.
What you can do with gmail-agent
gmail-agent is a Model Context Protocol (MCP) server published by dremok. It ranks #15,243 of 151,203 active servers on MCP Toplist. gmail-agent is listed across 2 registries — Official MCP and Glama, with 2 tracked versions. It was first listed on Oct 7, 2026 and most recently updated on Oct 11, 2026.
Not verifiedMCP Toplist has not yet written a checked profile for this server, so the paragraph above is assembled from registry data only. The repository README is the authority on what it does.
What gmail-agent can and cannot do
Not verifiedMCP Toplist has not catalogued this server's tools or limitations. The repository README lists them.
What you need before using gmail-agent
The registry listing declares no required environment variables or authentication. This is declared metadata, not a verified install — the repository README is the authority.
Declared by Glama, last synced Oct 23, 2026. Not independently verified by MCP Toplist.
- GMAIL_AGENT_CONFIG_DIR · optional
- GMAIL_AGENT_ALLOWED_DIRS · optional
Connect gmail-agent and confirm it works
claude mcp add gmail-agent -e "GMAIL_AGENT_CONFIG_DIR=<your GMAIL_AGENT_CONFIG_DIR>" -e "GMAIL_AGENT_ALLOWED_DIRS=<your GMAIL_AGENT_ALLOWED_DIRS>" -- uvx gmail-agent mcpReplace each placeholder with your own value before saving.
[mcp_servers.gmail-agent]
command = "uvx"
args = ["gmail-agent", "mcp"]
[mcp_servers.gmail-agent.env]
GMAIL_AGENT_CONFIG_DIR = "<your GMAIL_AGENT_CONFIG_DIR>"
GMAIL_AGENT_ALLOWED_DIRS = "<your GMAIL_AGENT_ALLOWED_DIRS>"Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"gmail-agent": {
"command": "uvx",
"args": [
"gmail-agent",
"mcp"
],
"env": {
"GMAIL_AGENT_CONFIG_DIR": "<your GMAIL_AGENT_CONFIG_DIR>",
"GMAIL_AGENT_ALLOWED_DIRS": "<your GMAIL_AGENT_ALLOWED_DIRS>"
}
}
}
}Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.
{
"mcpServers": {
"gmail-agent": {
"command": "uvx",
"args": [
"gmail-agent",
"mcp"
],
"env": {
"GMAIL_AGENT_CONFIG_DIR": "<your GMAIL_AGENT_CONFIG_DIR>",
"GMAIL_AGENT_ALLOWED_DIRS": "<your GMAIL_AGENT_ALLOWED_DIRS>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.
{
"servers": {
"gmail-agent": {
"type": "stdio",
"command": "uvx",
"args": [
"gmail-agent",
"mcp"
],
"env": {
"GMAIL_AGENT_CONFIG_DIR": "<your GMAIL_AGENT_CONFIG_DIR>",
"GMAIL_AGENT_ALLOWED_DIRS": "<your GMAIL_AGENT_ALLOWED_DIRS>"
}
}
}
}Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"gmail-agent": {
"command": "uvx",
"args": [
"gmail-agent",
"mcp"
],
"env": {
"GMAIL_AGENT_CONFIG_DIR": "<your GMAIL_AGENT_CONFIG_DIR>",
"GMAIL_AGENT_ALLOWED_DIRS": "<your GMAIL_AGENT_ALLOWED_DIRS>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"gmail-agent": {
"command": "uvx",
"args": [
"gmail-agent",
"mcp"
],
"env": {
"GMAIL_AGENT_CONFIG_DIR": "<your GMAIL_AGENT_CONFIG_DIR>",
"GMAIL_AGENT_ALLOWED_DIRS": "<your GMAIL_AGENT_ALLOWED_DIRS>"
}
}
}
}Replace each placeholder with your own value before saving.
After adding the config, ask your client to list this server's tools. A tool list confirms the connection; an empty list or an error means the server did not start or needs credentials.
What changed, and when this was checked
- First listed
- Oct 7, 2026
- Latest version published
- Oct 11, 2026
- Version history
- 2 versions tracked (below)
- Requirements evidence
- Declared by Glama, last synced Oct 23, 2026. Not independently verified by MCP Toplist.
- Profile checked
- Not yet — purpose, capabilities and requirements above come from registry data only
- Ranking data as of
- Oct 23, 2026
- Glama ↗listed since Oct 8, 2026 · still listed
- Official MCP ↗listed since Oct 12, 2026 · still listed
Do you maintain gmail-agent? to correct or enrich this profile.
Available versions (2)
| Version | Published |
|---|---|
| 0.3.1 | Oct 11, 2026 |
| 0.3.0 | Oct 11, 2026 |
Ranks ahead of 135,960 of 151,203 servers on MCP Toplist.
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.dremok%2Fgmail-agent)<a href="https://mcptoplist.com/server/io.github.dremok%2Fgmail-agent"><img src="https://mcptoplist.com/badge/io.github.dremok%2Fgmail-agent.svg" alt="MCP Toplist: Top 25% of 151,203" /></a>Variants: append ?metric=score or ?metric=stars to the image URL.
Frequently asked questions
- Who maintains gmail-agent?
- gmail-agent is maintained by dremok, which publishes 1 MCP server (2 total versions) tracked on MCP Toplist.
- Is gmail-agent listed on the Official MCP Registry?
- Yes — gmail-agent is listed on the Official MCP Registry, alongside Glama.
- How many versions does gmail-agent have?
- MCP Toplist tracks 2 versions of gmail-agent, most recently published on Oct 11, 2026.
- Where can I find the source code for gmail-agent?
- The source code for gmail-agent is hosted at github.com/dremok/gmail-agent.
Do you run this server?
Community projects list the MCP servers behind real agents and apps. Publish yours and this page will link to it.