mcpbeat Sign in

Mailwarden MCP Server

local only

Mailwarden runs on your own machine — the client starts it, so there is no endpoint to ping. 323 installs a week from npm. Last commit 20 Sep 2026.

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

Installs per day peak 259 · avg 38 · -71% w/w
a month agotoday
323
Installs / week
npm · mailwarden
0
Stars
1 open issues
20 Sep 2026
Last commit
0 releases in 90 days
MIT
License
TypeScript

What the code does

We read the source, 14 h ago · rules 3dff92dd89df

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

Runs an external command src/consent.ts:167
    spawn(cmd, args, {

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add mailwarden -- npx -y mailwarden
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "mailwarden": {
      "args": [
        "-y",
        "mailwarden"
      ],
      "command": "npx"
    }
  }
}
~/.codex/config.toml
[mcp_servers.mailwarden]
command = "npx"
args = ["-y", "mailwarden"]
.cursor/mcp.json
{
  "mcpServers": {
    "mailwarden": {
      "args": [
        "-y",
        "mailwarden"
      ],
      "command": "npx"
    }
  }
}
.vscode/mcp.json
{
  "mcpServers": {
    "mailwarden": {
      "args": [
        "-y",
        "mailwarden"
      ],
      "command": "npx"
    }
  }
}

This one needs environment variables set before it will start: 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)). The author declared them in the registry entry; get the values from the project itself.

Alternatives to Mailwarden

same job, measured the same way
Gmail MCP
by a1-x-tech

MCP server for the Gmail API: search, read and send email, manage drafts, labels and the trash.

182 installs/wk local only
Mailbox MCP
by jgalea

Multi-account email MCP server for Gmail, IMAP, and JMAP: search, send, drafts, labels.

71 installs/wk local only
Gmail
by markswendsen-code

Gmail MCP server — send, read, and search email. By Strider Labs.

20 installs/wk local only
Gmail
by mintmcp

A MCP server for Gmail that lets you search, read, and draft emails and replies.

answering
Commune
by shanjai-raj

Email and SMS MCP server for AI agents — 41 tools for inboxes, sending, search, and SMS.

147 installs/wk local only
Outlook Email
by mintmcp

A MCP server for Outlook email that lets you search, read, and draft emails and replies.

answering
Email
by primitive

Email infrastructure for AI agents — send, receive, search, and reply to email over MCP.

30 tools answering
Multi-Account Gmail
by cunicopia-dev

Multi-account Gmail MCP server — read, search, draft, and label across every inbox.

369 installs/wk local only

Mailwarden — questions

Answers built from our own checks of this server.

Why is there no uptime for Mailwarden?
Mailwarden runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package mailwarden was installed 323 times last week.
How do I connect Mailwarden?
Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It runs locally, so the command pulls mailwarden straight from npm; nothing to host, nothing to sign up for.
How many people use Mailwarden?
The npm package mailwarden was installed 323 times in the last week. Week over week that is -71%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Mailwarden open source?
Yes — it is published under the MIT licence, written in TypeScript, 0 stars on GitHub and 1 open issue. The source link is on this page, so you can read exactly what it does with your data before you connect it.