HomeCommunication › mailwarden

mailwarden

Gmail MCP server for email triage: search, labels, archive, trash, unsubscribe, snooze.

TypeScript Local macOSWindowsLinux
★ 0 stars Last pushed 2026-09-22 License: MIT

Topics: Communication

Connect

Review any command before running it. Package names and URLs come from the server's own registry entry.

Package (npm 0.22.0)

npx -y mailwarden@0.22.0

Or add to your MCP client config:

{
  "mcpServers": {
    "mailwarden": {
      "command": "npx",
      "args": [
        "-y",
        "mailwarden@0.22.0"
      ],
      "env": {
        "MAILWARDEN_DIR": "<YOUR_VALUE>",
        "MAILWARDEN_CREDENTIALS": "<YOUR_VALUE>",
        "MAILWARDEN_AUTO_SWEEP": "<YOUR_VALUE>",
        "MAILWARDEN_DOWNLOAD_DIR": "<YOUR_VALUE>"
      }
    }
  }
}
  • MAILWARDEN_DIR — Config directory (default ~/.mailwarden), holds credentials.json and token.json
  • MAILWARDEN_CREDENTIALS — Path to the Google OAuth credentials.json (Desktop app client)
  • MAILWARDEN_AUTO_SWEEP — Set to 1 to sweep due snoozes at startup and hourly while running
  • MAILWARDEN_DOWNLOAD_DIR — Restrict download_attachment writes to this directory (recommended for HTTP hosting)

Related servers

Listed in punkpeye/awesome-mcp-servers (MIT)

Data from the Official MCP Registry