Assistant Mail MCP server

by AssistantMail·io.github.AssistantMail/assistantmail-mcp·v1.3.1

No reviews yet

Agent email with allowlist and consent via AssistantMail.

B77/100grade B

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

B77/100

full report

Adoption

New

0 stars38 downloads/wk

Reviews

Write one

Nobody has reviewed Assistant Mail MCP yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Assistant Mail MCP tools (22, 8 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

assistantmail_add_recipient
Adds a recipient and sends a consent invitation when required.
assistantmail_create_mailboxwrite action
Creates a mailbox for the authenticated account.
assistantmail_delete_mailboxwrite action
Deletes a mailbox and all associated messages.
assistantmail_delete_messageswrite action
Deletes messages from a mailbox by IDs or deletes all messages.
assistantmail_get_inbound_policy
Gets inbound email policy settings for the authenticated account.
assistantmail_get_mailbox
Gets mailbox metadata for a mailbox ID.
assistantmail_get_me
Gets account profile and tier metadata for the authenticated account.
assistantmail_get_message
Gets a specific message for a mailbox, including hydrated text/html bodies when available.
assistantmail_get_message_reference
Provides the AssistantMail REST endpoint for fetching a single message including its full body content.
assistantmail_get_usage
Gets daily and monthly send quota usage for a mailbox.
assistantmail_get_usage_reference
Provides the AssistantMail REST endpoint for checking send quota usage for a mailbox.
assistantmail_health
Returns AssistantMail MCP server and API endpoint metadata.
assistantmail_list_mailboxes
Lists mailboxes accessible to the authenticated account.
assistantmail_list_messages
Lists inbound and outbound messages for a mailbox.
assistantmail_list_messages_reference
Provides the AssistantMail REST endpoint for listing messages (inbound and outbound) in a mailbox.
assistantmail_list_recipients
Lists approved/pending recipients for the authenticated account.
assistantmail_remove_recipientwrite action
Removes a recipient from the allowed recipient list.
assistantmail_reply_message
Replies to an existing message in a mailbox thread.
assistantmail_send_emailwrite action
Queues an outbound email for a mailbox.
assistantmail_send_email_referencewrite action
Provides the AssistantMail REST endpoint and required headers for email send requests.
assistantmail_update_inbound_policywrite action
Updates inbound email policy for the authenticated account.
assistantmail_update_mailboxwrite action
Updates mailbox metadata (currently display name).

Public scan report

scanner v0.1.10 · 2026-10-16 · same rubric, same numbers if you re-run it

no findings

Code scan2 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitystatic API keys via environment variables6/15
Maintenancelast push 36 days ago12/15
Maintainer identityregistry namespace matches repository owner7/10

Overall 77/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How Assistant Mail MCP compares

Against every graded Email MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 77/100; higher than 50% of 916 Email servers
Tools: 22; the typical Email server has 7
Tools that change things: 36%; typical: 25%. Fewer write tools means less an agent can break
Downloads a week: 38; more than 23% of 235 Email servers with a package

What its tools let an agent do: 14 read · 8 change

Install Assistant Mail MCP in Claude Code, Cursor or VS Code

Runs npx -y @assistantmail/assistantmail-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add assistantmail-mcp -- npx -y @assistantmail/assistantmail-mcp

Add to Cursor

What the publisher says

From the Assistant Mail MCP repository's README, as published. We do not edit it. Read it on GitHub

assistantmail-mcp

MCP server for AssistantMail — give AI agents a managed mailbox to send and receive email.

Built for personal and small-team OpenClaw / Hermes operators who want agent email with allowlist, consent, retention, and spend caps you control. Listed on ClawHub for easy install — not an official OpenClaw endorsement.

Get Free · Docs · Website · Privacy · Terms · Contributing

OpenClaw / ClawHub

openclaw skills install @assistantmail/assistant-mail

Then configure your MCP client to run this server and set ASSISTANTMAILAPI_KEY (Claude Desktop and Cursor examples below). Skill: assistant-mail on ClawHub. Same MCP works with Hermes.

Installation

npx -y @assistantmail/assistantmail-mcp

Node 24+.

Claude Desktop

{
  "mcpServers": {
    "assistantmail": {
      "command": "npx",
      "args": ["-y", "@assistantmail/assistantmail-mcp"],
      "env": {
        "ASSISTANT_MAIL_API_KEY": "amk_..."
      }
    }
  }
}

Cursor / VS Code (.cursor/mcp.json or .vscode/mcp.json)

{
  "servers": {
    "assistantmail": {
      "command": "npx",
      "args": ["-y", "@assistantmail/assistantmail-mcp"],
      "env": {
        "ASSISTANT_MAIL_API_KEY": "amk_..."
      }
    }
  }
}

Prerequisites

Create a free account via the Get Free link above (1 agent, 25/day; current limits: Docs).
Go to API Keys and create a key (amk_...). Copy it immediately — it is only shown once.
Set ASSISTANTMAILAPIKEY; call assistantmaillist_mailboxes to get your mailboxId UUID. Mail API routes use that UUID, not an email address.

Paid plans: upgrade in-app only (not Payment Links). Use Upgrade in the AssistantMail app — checkout is not sold via Stripe Payment Links. Docs: assistant-mail.ai/docs

Official MCP Registry

The listing is live as io.github.AssistantMail/assistantmail-mcp on the Official MCP Registry. Product docs: assistant-mail.ai/docs.

Packaging lives in server.json. After a version bump, republish with mcp-publisher — see docs/MCP_REGISTRY.md.

Environment variables

Tools

Diagnostics

Account

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Assistant Mail MCP: common questions

Is Assistant Mail MCP server safe?: Mostly: it is graded B (77/100). Read the Assistant Mail MCP safety report
How do I install Assistant Mail MCP?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Assistant Mail MCP need an API key?: Yes. The registry entry asks for ASSISTANT_MAIL_API_KEY.
Is Assistant Mail MCP maintained?: The last commit was 56 days ago (2026-09-10). The latest release is v1.3.1.
What can I use instead of Assistant Mail MCP?: Servers from other publishers that do the same job: Agent-Native Mail MCP server, Atomic Mail MCP server and Agenticmail MCP server.
How does Assistant Mail MCP compare with other Email MCP servers?: safety score 77/100 (higher than 50% of 916 Email servers); tools 22 (the typical Email server has 7); tools that change things 36% (typical: 25%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Assistant Mail MCP

Same job from other publishers: the closest match first, then the best rated.

Agent-Native Mail
Agent-Native Superhuman - email client with keyboard shortcuts and AI triage
not reviewed
Established
A
Atomic Mail
Programmable email inbox for AI agents — JMAP, PoW auth, stdio MCP server.
not reviewed
Established
A
Agenticmail
Real email and SMS for AI agents — send mail, receive verification codes, drive a real inbox.
not reviewed
Established
B
smbCloud Mail & Auth
Email infrastructure and authentication for developers: domains, inbox routes, auth apps, deploys.
not reviewed
Established
A
Openagentemail
Unlimited agent mailboxes — create identities, read/wait for mail, extract OTPs, send email.
not reviewed
Growing
B

Run it through the gateway

Local package. It runs on your machine, not through the gateway.

Rating: —
Safety grade: B · 77/100
Stars: 0
Downloads/wk: 38
Price: Free
Licence: MIT
Transport: Local · npm
Version: 1.3.1
Category: Email
Last release: 2026-09-10

Credentials it needs

ASSISTANT_MAIL_API_KEYsecretAssistantMail API key (amk_...). Required unless passed per-tool.
ASSISTANT_MAIL_API_BASE_URLOptional AssistantMail API base URL.

Own this server?

Claim it to keep the listing current and reply to reviews. Claiming never changes the grade or hides a review.

Claim listing

Badge for your README

Shows the safety grade and links back to this page. It updates itself after every scan and review.

[![mcp.market](https://mcp.market/badge/assistantmail-assistantmail-mcp.svg)](https://mcp.market/server/assistantmail-assistantmail-mcp)

How the badge works