Gmail MCP server for email triage: search, labels, archive, trash, unsubscribe, snooze.
Connect Runs on your machine
claude mcp add mailwarden -e MAILWARDEN_DIR=<MAILWARDEN_DIR> -e MAILWARDEN_CREDENTIALS=<MAILWARDEN_CREDENTIALS> -e MAILWARDEN_AUTO_SWEEP=<MAILWARDEN_AUTO_SWEEP> -e MAILWARDEN_DOWNLOAD_DIR=<MAILWARDEN_DOWNLOAD_DIR> -- npx -y [email protected]{
"mcpServers": {
"mailwarden": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"MAILWARDEN_DIR": "<MAILWARDEN_DIR>",
"MAILWARDEN_CREDENTIALS": "<MAILWARDEN_CREDENTIALS>",
"MAILWARDEN_AUTO_SWEEP": "<MAILWARDEN_AUTO_SWEEP>",
"MAILWARDEN_DOWNLOAD_DIR": "<MAILWARDEN_DOWNLOAD_DIR>"
}
}
}
}{
"mcpServers": {
"mailwarden": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"MAILWARDEN_DIR": "<MAILWARDEN_DIR>",
"MAILWARDEN_CREDENTIALS": "<MAILWARDEN_CREDENTIALS>",
"MAILWARDEN_AUTO_SWEEP": "<MAILWARDEN_AUTO_SWEEP>",
"MAILWARDEN_DOWNLOAD_DIR": "<MAILWARDEN_DOWNLOAD_DIR>"
}
}
}
}{
"servers": {
"mailwarden": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"MAILWARDEN_DIR": "<MAILWARDEN_DIR>",
"MAILWARDEN_CREDENTIALS": "<MAILWARDEN_CREDENTIALS>",
"MAILWARDEN_AUTO_SWEEP": "<MAILWARDEN_AUTO_SWEEP>",
"MAILWARDEN_DOWNLOAD_DIR": "<MAILWARDEN_DOWNLOAD_DIR>"
}
}
}
}Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
MAILWARDEN_DIROptional | Config directory (default ~/.mailwarden), holds credentials.json and token.json |
MAILWARDEN_CREDENTIALSOptional | Path to the Google OAuth credentials.json (Desktop app client) |
MAILWARDEN_AUTO_SWEEPOptional | Set to 1 to sweep due snoozes at startup and hourly while running |
MAILWARDEN_DOWNLOAD_DIROptional | Restrict download_attachment and export_thread writes to this directory (recommended for HTTP hosting) |
Details
| Package | [email protected] (NPM, stdio) |
| First published | 10 Nov 2026 |
| Last updated | 10 Nov 2026 |
| Registry name | io.github.csitte/mailwarden |
More communication servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.