Agents Index

Primitive Email

Online

Email infrastructure for AI agents — send, receive, search, and reply to email over MCP.

Visit publisherConnectJSON

What it can do: 14 tools

  • getAccount read-onlyThe authenticated Primitive account. managed_inbox_address is a domain, not a mailbox; sender_address (such as agent@pink-ram.primitive.email) is the mailbox sendEmail sends from by default. Result: id, email, plan, mana
  • getInboxStatus read-onlyCheck whether inbound email is ready. Domains are added and verified with the domain management tools at /mcp/full. Result: ready, receiving_ready, processing_ready, summary, next_actions, domains, endpoints, functions a
  • getOutboundStatus read-onlyWhat this account can send from, and to whom. Call it before sending outside Primitive or from a domain other than the managed inbox. Result: ready, summary, sendable_domains, domains, next_actions, and can_send_to, the
  • listEmails read-onlyPage through inbound email newest first, or tail new mail with since and wait. Filters by domain, status, date and sender, recipient or subject words; for body text, attachments or replies to a send, use searchEmails. Ro
  • searchEmails read-onlyFind particular inbound emails: a full-text query (q) over subject, body, sender and recipient, or filters on sender, recipient, subject, body, attachments, spam score, or the sent email they reply to, ranked by relevanc
  • getEmail read-onlyRead one inbound email by id; read its attachments with getEmailAttachment. By default body_text leaves out quoted history and shows each link as an [n] marker; the links argument returns their targets. When body_next_of
  • replyToEmailReply to one inbound email, threaded server-side. This sends a real email immediately and it cannot be undone or recalled, so call it only after the user has confirmed the reply. Expecting an answer? Pass await_reply: tr
  • sendEmailSend a new email. It goes out immediately (or at scheduled_at) and cannot be recalled, so confirm the message with the user first. Leave `from` out to send from your managed inbox. To send later, set scheduled_at, at mos
  • listSentEmails read-onlyList sent emails to audit delivery. Rows carry id, thread_id, created_at, status, from, to, subject and snippet, plus error_code, smtp_response_code or gates when a send did not deliver. Read one with getSentEmail. Resul
  • getSentEmail read-onlyRead a single sent email by id, to inspect its delivery, such as the SMTP response on a bounced send or the gate denial on a gate_denied one. Pass full: true for the stored record. Result: id, thread_id, created_at, stat
  • awaitReply read-onlyWait for the threaded reply to a sent email (an id sendEmail or replyToEmail returned) when that send's own wait got none. Do not tell the user nobody replied unless this returns reply null with timed_out true. Threading
  • getConversation read-onlyRead a whole conversation with message bodies: the tool for finding out what was said. Pass the id of any inbound email in the thread. Each message has a direction and a role (inbound→user, outbound→assistant). Texts hav
  • getEmailAttachment read-onlyRead ONE attachment of an email. A text file (plain text, CSV, JSON, XML, Markdown, calendar and similar) comes back as text, HTML reduced to text; a PNG, JPEG, GIF or WebP image up to 1 MB as an image; any other file as
  • createEmailAddressCreate an email account with no signup and get its api_key; call this first when you have no Primitive API key and the user wants to send or receive email. Pass api_key as the `api_key` argument on every later Primitive

Connect it

Claude Code
claude mcp add --transport http primitive-email https://www.primitive.dev/mcp
Claude.ai / ChatGPT
Settings → Connectors → Add custom connector
URL: https://www.primitive.dev/mcp
Cursor (~/.cursor/mcp.json)
{
  "mcpServers": {
    "primitive-email": {
      "url": "https://www.primitive.dev/mcp"
    }
  }
}
VS Code (.vscode/mcp.json)
{
  "servers": {
    "primitive-email": {
      "type": "http",
      "url": "https://www.primitive.dev/mcp"
    }
  }
}

Questions

What does Primitive Email do?

Email infrastructure for AI agents — send, receive, search, and reply to email over MCP. It exposes 14 tools to AI assistants.

What tools does Primitive Email provide?

14 tools, including getAccount, getInboxStatus, getOutboundStatus, listEmails, searchEmails, getEmail, replyToEmail, sendEmail, listSentEmails, getSentEmail, awaitReply, getConversation….

How do I connect Primitive Email to Claude, ChatGPT or Cursor?

Add the remote MCP endpoint https://www.primitive.dev/mcp as a custom connector or MCP server. Copy-paste setup is on this page.

Does Primitive Email require an account or API key?

No sign-in was needed to list its tools. Individual tools may still need an account or API key.

Is Primitive Email online?

As of 2026-11-19 our probe found it online. It answered 100% of our last 3 checks.

Who publishes Primitive Email?

primitive.dev. The official MCP Registry verified that the publisher controls this domain before accepting the listing.

Similar in Communication