io.github.csitte/mailwarden MCP Server

Name: io.github.csitte/mailwarden MCP Server
Author: io.github.csitte

io.github.csitte/mailwarden

Repository Registry

What is the io.github.csitte/mailwarden MCP server?

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

How to install io.github.csitte/mailwarden

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

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)

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mailwarden": {
      "command": "npx",
      "args": [
        "-y",
        "mailwarden"
      ],
      "env": {
        "MAILWARDEN_DIR": "<YOUR_MAILWARDEN_DIR>",
        "MAILWARDEN_CREDENTIALS": "<YOUR_MAILWARDEN_CREDENTIALS>",
        "MAILWARDEN_AUTO_SWEEP": "<YOUR_MAILWARDEN_AUTO_SWEEP>",
        "MAILWARDEN_DOWNLOAD_DIR": "<YOUR_MAILWARDEN_DOWNLOAD_DIR>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "mailwarden": {
      "command": "npx",
      "args": [
        "-y",
        "mailwarden"
      ],
      "env": {
        "MAILWARDEN_DIR": "<YOUR_MAILWARDEN_DIR>",
        "MAILWARDEN_CREDENTIALS": "<YOUR_MAILWARDEN_CREDENTIALS>",
        "MAILWARDEN_AUTO_SWEEP": "<YOUR_MAILWARDEN_AUTO_SWEEP>",
        "MAILWARDEN_DOWNLOAD_DIR": "<YOUR_MAILWARDEN_DOWNLOAD_DIR>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mailwarden": {
      "command": "npx",
      "args": [
        "-y",
        "mailwarden"
      ],
      "env": {
        "MAILWARDEN_DIR": "<YOUR_MAILWARDEN_DIR>",
        "MAILWARDEN_CREDENTIALS": "<YOUR_MAILWARDEN_CREDENTIALS>",
        "MAILWARDEN_AUTO_SWEEP": "<YOUR_MAILWARDEN_AUTO_SWEEP>",
        "MAILWARDEN_DOWNLOAD_DIR": "<YOUR_MAILWARDEN_DOWNLOAD_DIR>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "mailwarden": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mailwarden"
      ],
      "env": {
        "MAILWARDEN_DIR": "<YOUR_MAILWARDEN_DIR>",
        "MAILWARDEN_CREDENTIALS": "<YOUR_MAILWARDEN_CREDENTIALS>",
        "MAILWARDEN_AUTO_SWEEP": "<YOUR_MAILWARDEN_AUTO_SWEEP>",
        "MAILWARDEN_DOWNLOAD_DIR": "<YOUR_MAILWARDEN_DOWNLOAD_DIR>"
      }
    }
  }
}

Claude Code

claude mcp add mailwarden --env MAILWARDEN_DIR=<YOUR_MAILWARDEN_DIR> --env MAILWARDEN_CREDENTIALS=<YOUR_MAILWARDEN_CREDENTIALS> --env MAILWARDEN_AUTO_SWEEP=<YOUR_MAILWARDEN_AUTO_SWEEP> --env MAILWARDEN_DOWNLOAD_DIR=<YOUR_MAILWARDEN_DOWNLOAD_DIR> -- npx -y mailwarden