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. 2 075 installs a week from npm. Last commit 7 Nov 2026.

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

Installs per day peak 262 · avg 47 · -29% w/w
a month agotoday
2 075
Installs / week
npm · mailwarden
0
Stars
1 open issue
7 Nov 2026
Last commit
30 releases in 90 days
MIT
License
TypeScript

What the code does

We read the source, 8 h ago · rules 995398eba69f

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, {
Builds a file path from a variable assets/icon/render.py:63
    out = lambda name: os.path.join(here, name)

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": {
      "command": "npx",
      "args": [
        "-y",
        "mailwarden"
      ]
    }
  }
}
~/.codex/config.toml
[mcp_servers.mailwarden]
command = "npx"
args = ["-y", "mailwarden"]
.cursor/mcp.json
{
  "mcpServers": {
    "mailwarden": {
      "command": "npx",
      "args": [
        "-y",
        "mailwarden"
      ]
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "mailwarden": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mailwarden"
      ]
    }
  }
}

Optional settings from the registry entry, left out of the block above: 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 and export_thread writes to this directory (recommended for HTTP hosting)).

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.

734 installs/wk local only
Mailbox MCP
by jgalea

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

176 installs/wk local only
Gmail
by markswendsen-code

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

37 installs/wk local only
Gmail
by mintmcp

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

answering
Mailoo - Email MCP Server
by bitfloo

Email MCP server for AI agents: IMAP/SMTP, Gmail, Outlook, calendar, ManageSieve, AI triage, OAuth2.

720 installs/wk local only
Commune
by shanjai-raj

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

162 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
Maylee
by maylee

Maylee AI email: read, search, triage, draft and send; manage labels, views and AI label rules.

answering

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 2 075 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 in the form 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 2 075 times in the last week. Week over week that is -29%. 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.