Mailcatcher logoMailcatcher
Get started
Back to Changelog

mailcatcher.dev now exposes an MCP server, letting AI assistants read and inspect your test emails directly.

MCP Server

You can now connect AI assistants — Claude Desktop, Cursor, and any other MCP-compatible client — directly to your Mailcatcher inbox.

🎉 What's new

  • MCP server at /_mcp — supports both HTTP and stdio transports, compatible with all major MCP clients
  • Personal API tokens — generate a token from your profile page; it is shown once and stored as a bcrypt hash
  • Instant revocation — tokens can be revoked at any time from the profile page
  • Four tools available to AI assistants:
    • whoami — returns your name, email, and organisation
    • list-projects — lists all projects (inboxes) you have access to
    • list-emails — paginated email list for a given project
    • show-email — full email content including HTML, plain text, headers, and attachments

🔐 Security

The MCP endpoint is guarded by a dedicated stateless firewall — completely separate from the session-based web authentication. Tokens are scoped to the generating user and their organisation, giving exactly the same data access as a normal web session.

See the MCP Server documentation for setup instructions and a full tool reference.

Older

Change User Roles