How do I install the mailwarden mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `MAILWARDEN_TOKEN`, `MAILWARDEN_ALLOW_NO_TOKEN`, `MAILWARDEN_HOST` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Mailwarden MCP Server

Native Gmail MCP server: search, labels, archive, trash, attachments, and snooze.

Local serverstdio

What is the Mailwarden MCP Server?

Native Gmail MCP server: search, labels, archive, trash, attachments, and snooze.

What the server does

A reliable, native Gmail MCP server — full mailbox triage for AI assistants, with the feature nobody else ships: snooze.

Snooze — the feature nobody else ships. — Archive a thread now, have it resurface in the inbox
Search you can trust. — Gmail's own search index silently drops is:unread in some operator
Bulk operations that scale. — bulk_modify archives/labels everything matching a query at
Structured outputs. — Every tool declares an outputSchema and returns validated
Small attack surface. — No send tools (no exfiltration path for prompt-injected mail),
Correct with real-world mail. — RFC 2047 headers decoded (=?UTF-8?B?…?= → readable text),

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
Criteria	from, to, subject, query (full Gmail search syntax), negatedQuery,
Actions	label only): addLabels / removeLabels, by name or id (an unknown name in
search	10 per list page, plus 40 for every candidate thread it fetches — about 1,000 at the default size, up to about 4,000 when the query carries a read-state or cate
get_thread	Full thread: headers, plaintext + HTML bodies, attachment metadata. Every message also carries authentication — SPF/DKIM/DMARC as the receiving server reported
list_labels	All labels (system + user)
get_profile	Connected account's address, total message/thread counts and the mailbox's current historyId — confirm which mailbox is wired up before acting
what_changed	Mailbox events since a historyId you hold — arrivals, removals, labels on and off, in one call
list_unsubscribe	What opt-out options a thread advertises (List-Unsubscribe), plus body links when it advertises none — contacts nobody
create_label	Create a user label (idempotent; nested via Parent/Child) and return its id; an optional backgroundColor/textColor pair colours it, including one that already e
modify_labels	Add/remove labels by name or id — an unknown name in add is auto-created (archive = remove INBOX, read = remove UNREAD)
download_attachment	Save an attachment to a local path (never overwrites — collisions get a numeric suffix)
list_filters	All Gmail filters (criteria + label actions); surfaces any forward address on existing filters for auditing
create_filter	Create a server-side auto-triage rule (criteria → label actions only; no forwarding — see below). Optionally applyToExisting to also sweep matching mail already
delete_filter	Delete a filter by id
bulk_modify	5 per 500 matching messages, plus 50 per 1,000 modified; verify: true adds 40 per thread, crossCheck 5 per condition and 500 matches

How to install the Mailwarden MCP Server

{
  "mcpServers": {
    "mailwarden": {
      "command": "npx",
      "args": [
        "-y",
        "mailwarden"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Example prompts to try

“Use Mailwarden to search.”
“Use Mailwarden to get thread.”
“Use Mailwarden to list labels.”

Frequently asked questions

Native Gmail MCP server: search, labels, archive, trash, attachments, and snooze. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.