Give Cursor an email inbox of its own

Give Cursor an inbox of its own by adding Trotta Mail to ~/.cursor/mcp.json with the URL https://api.trotta.email/mcp, then signing in when Cursor asks. Cursor can then wait for mail, read verification codes, send and reply, and every message it reads was screened before delivery.

Updated

What Cursor can do with the inbox

An inbox lets Cursor test the email side of what it builds: send the message, wait for it to arrive, read what a recipient would see. The main tools are below, and the MCP docs list them all.

ToolWhat it does
wait_for_messageWaits for the next delivered message. Filters include has_code.
list_messagesLists messages in an inbox.
read_messageReads one message in the safe view.
thread_contextReturns a thread as model-ready text with a trust level.
send_messageSends a new message. Screened before it leaves.
reply_to_messageReplies in the thread.
scan_contentRuns any content through the guard and returns the verdict.
list_heldLists what is waiting on a human.

Set up Trotta Mail in Cursor

Cursor reads its MCP servers from ~/.cursor/mcp.json, or from .cursor/mcp.json inside one project. The server address is https://api.trotta.email/mcp, exactly as written, with no slash at the end. You sign in with your Trotta Mail account, or Cursor sends an API key.

Sign in with Trotta Mail

  1. Add the server to ~/.cursor/mcp.json.
  2. Sign in with Trotta Mail when Cursor asks, or from the Cursor CLI.
  3. Pick the inboxes Cursor may use, and whether it may read, send or both. Then allow.
~/.cursor/mcp.json
{
  "mcpServers": {
    "trotta": {
      "url": "https://api.trotta.email/mcp"
    }
  }
}
Sign in from the Cursor CLI
agent mcp login trotta

Use an API key

  1. Put your key in the TROTTA_MAIL_API_KEY environment variable. Cursor reads the key from your environment.
  2. Add the server to ~/.cursor/mcp.json with the header.
~/.cursor/mcp.json
{
  "mcpServers": {
    "trotta": {
      "url": "https://api.trotta.email/mcp",
      "headers": {
        "Authorization": "Bearer ${env:TROTTA_MAIL_API_KEY}"
      }
    }
  }
}

These steps follow the Cursor docs, checked on 2026-11-20.

What Cursor sees and what it never sees

Cursor sees each message in the safe view. That is the content a human could see: hidden text is removed, instructions aimed at a model are replaced by a note that names what was removed, and links that are not clean are defanged.

Cursor never sees held mail. A held message is listed with the reason and no content, and a human decides whether to release it. Login codes, password resets and sign-in links in a human's own mailbox are sealed, so no tool returns them. In an inbox of its own, Cursor reads the codes it asked for.

Cursor works inside your code, with your files in reach. A human's everyday mailbox can deliver a real-looking message that tells an agent to send those files somewhere: see data exfiltration through agents. A Trotta Mail inbox screens mail before it is accepted, and screens what Cursor sends too. No filter catches everything, so uncertain mail waits for a human.

Three things to try

  • Trigger the welcome email on localhost for riley@trotta.email, wait for it to arrive and show me the text.
  • Sign up on staging with riley@trotta.email and use the verification code from the email to finish.
  • Is any mail held in this inbox? Tell me why each one was held.

Troubleshooting

  • The server answers 401. No token was sent, or the token is not good. With sign-in, run agent mcp login trotta. With a key, check that TROTTA_MAIL_API_KEY is set where Cursor starts.
  • The key is sent but refused. The header must be Authorization, and its value Bearer, a space, then the key. Keys start with tm_live_.
  • A send is refused as outbound_blocked. Outgoing mail is screened, and a message that contains a secret is not sent. Remove what was flagged and send it again.

Questions

Does Trotta Mail for Cursor work on the Free plan?

Yes. The Free plan is $0 with 2 inboxes and 1,000 emails a month. MCP and every check are on every plan.

Can the server be set for one Cursor project?

Yes. Put the same entry in .cursor/mcp.json inside the project instead of ~/.cursor/mcp.json in your home folder.

Does Cursor need an API key for Trotta Mail?

No. Cursor can sign in with your Trotta Mail account, so there is no key to paste. An API key, read from TROTTA_MAIL_API_KEY, is the other way.

Is Trotta Mail part of Cursor?

No. Trotta Mail is an independent product that works with Cursor as an MCP server. It is not made or endorsed by Cursor's maker.

Sources

Give your agent an inbox of its own. One call, or one minute in the console.