MCP server for Gmail integration with email categorization, search, archive, and delete capabilities
GmailMcpServer MCP server is a locally run integration for AI assistants that speak the Model Context Protocol. MCP server for Gmail integration with email categorization, search, archive, and delete capabilities.
A comprehensive Model Context Protocol (MCP) server that integrates with Gmail API to provide intelligent email management capabilities. Features advanced email categorization, search, archiving, deletion, and automated cleanup with 25+ MCP tools for complete email lifecycle management.
Once GmailMcpServer is connected, these are the calls the assistant has available:
Prerequisites — The Prerequisites tool exposed by this serverauthenticate — The authenticate tool exposed by this serverlist_emails — The list_emails tool exposed by this serverget_email_details — The get_email_details tool exposed by this servercategorize_emails — Analyze and categorize emails by importance using AI algorithmssearch_emails — Advanced multi-criteria email search with intelligent filteringsave_search — The save_search tool exposed by this serverlist_saved_searches — The list_saved_searches tool exposed by this serverarchive_emails — The archive_emails tool exposed by this serverrestore_emails — The restore_emails tool exposed by this servercreate_archive_rule — The create_archive_rule tool exposed by this serverlist_archive_rules — The list_archive_rules tool exposed by this serverYou will need 3 environment variables: GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, STORAGE_PATH. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.
Installation goes through your MCP client rather than a global install: point it at npm on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.
This sits in the team communication group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. GmailMcpServer's toolset — Prerequisites, authenticate, list_emails and 11 more — is a fair guide to whether it matches your workflow. It is maintained by kushal45; worth a glance at recent repository activity before you build anything load-bearing on it.
This entry was verified against GmailMcpServer's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.
| Tool | What it does |
|---|---|
| Prerequisites | The Prerequisites tool exposed by this server. |
| authenticate | The authenticate tool exposed by this server. |
| list_emails | The list_emails tool exposed by this server. |
| get_email_details | The get_email_details tool exposed by this server. |
| categorize_emails | Analyze and categorize emails by importance using AI algorithms. |
| search_emails | Advanced multi-criteria email search with intelligent filtering. |
| save_search | The save_search tool exposed by this server. |
| list_saved_searches | The list_saved_searches tool exposed by this server. |
| archive_emails | The archive_emails tool exposed by this server. |
| restore_emails | The restore_emails tool exposed by this server. |
| create_archive_rule | The create_archive_rule tool exposed by this server. |
| list_archive_rules | The list_archive_rules tool exposed by this server. |
| export_emails | Export emails to external formats with cloud upload support. |
| delete_emails | ⚠️ **Safety Note:** Always use dry_run: true first to preview deletions |
{
"mcpServers": {
"gmailmcpserver": {
"command": "npx",
"args": ["-y", "npm"],
"env": {
"GOOGLE_CLIENT_ID": "your-value",
"GOOGLE_CLIENT_SECRET": "your-value",
"STORAGE_PATH": "your-value"
}
}
}
}Add to claude_desktop_config.json, then restart Claude Desktop.
| Variable | Description | Required |
|---|---|---|
| GOOGLE_CLIENT_ID | Configuration value read at startup. | Optional |
| GOOGLE_CLIENT_SECRET | Credential the server authenticates with. | Yes |
| STORAGE_PATH | Filesystem location the server is allowed to use. | Optional |
Your assistant inside the workspace — read channels, search history, post messages and tame the noise.
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.
Exposes REST APIs defined by OpenAPI specifications as Model Context Protocol (MCP) tools, facilitating seamless integration into MCP-based workflows.