Name: Email
Author: primitive

Email MCP

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

not scanned Remote · Streamable HTTP No auth needed 14 tools v0.2.0

No reviews yet by primitive The publisher’s own endpoint — this marketplace is not in the path

tools declared

—

trust score

remote

at its publisher

—

calls last 7d

What it does

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

Quickstart

# 1 — add it to Claude Code
claude mcp add --scope user --transport http primitive-email-mcp https://www.primitive.dev/mcp

# 2 — ask your agent for something these tools do
#   getAccount, getInboxStatus, getOutboundStatus and 11 more

Email costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.

Publishernot claimed

primitive1 server

1 category

All 1 server

Collected from a public index. Nobody has claimed this account, so nothing here was written by its author — claim it if it is yours.

Tool surface

What the model actually sees. Descriptions are diffed on every release — see version history.

Only tools that write or reach the network

Use this when you need the authenticated Primitive account summary, including plan, onboarding state, and managed inbox domain. managed_inbox_address is a domain, not a complete mailbox. When it is non-null, this MCP result also includes sender_address, such as agent@pink-ram.primitive.email, which sendEmail uses as the sender when from is omitted.

Parameter	Type	Required	Notes
api_key	string	no	Primitive API key (prim_...). Only needed when this connection has no signed-in account: pass the api_key returned by createEmailAddress, unchanged, on every call for the rest of the conversation. Omi

Use this when the user asks whether inbound email is ready or needs setup. Returns domains, routes, deployed Functions, and recent inbound activity. Adding or verifying a domain is done with the domain management tools, which are served at /mcp/full.

Parameter	Type	Required	Notes
api_key	string	no	Primitive API key (prim_...). Only needed when this connection has no signed-in account: pass the api_key returned by createEmailAddress, unchanged, on every call for the rest of the conversation. Omi

What can I send FROM? Lists this account's verified outbound (sendable) domains plus any domains still pending DNS verification, with next actions. The result also carries can_send_to: the recipients this account is allowed to send to. Call this before sending to an address outside Primitive, or to send from a domain other than the managed inbox. The same sendable list is echoed in a cannot_send_f

Parameter	Type	Required	Notes
api_key	string	no	Primitive API key (prim_...). Only needed when this connection has no signed-in account: pass the api_key returned by createEmailAddress, unchanged, on every call for the rest of the conversation. Omi

Browse the inbox in arrival order. Use this for "what arrived most recently" (newest first, a page at a time with cursor) and for waiting on new mail (pass since, plus wait to hold the request until something arrives). It filters by domain, status, date range and a simple search over sender, recipient and subject. To find particular messages by body text, attachment, spam score, or the sent email

Parameter	Type	Required	Notes
cursor	string	no	Backward (history) pagination cursor from a previous response's meta.cursor field: returns emails OLDER than this position, newest-first. Not a date: to filter by time use date_from or date_to.
since	string	no	Forward-tail cursor: start, or a meta.cursor value from a previous response (format {ISO datetime}\|{UUID}). Returns emails strictly NEWER than this position, oldest-first, for lossless polling o
wait	integer	no	Long-poll up to this many whole seconds (0 to 30, default 0) holding the request for new mail instead of returning an empty page immediately. Requires since. Returns as soon as matching mail arrives
limit	integer	no	Maximum number of emails to return (1 to 100, default 50).
domain_id	string	no	Filter to emails received on a specific verified domain.
status	string	no	Filter to emails in this processing status.
search	string	no	Free-text search across sender, recipient, and subject.
date_from	string	no	Inclusive lower bound on created_at. An ISO 8601 date-time with Z or a UTC offset ("2026-10-01T09:00:00Z", "2026-10-01T09:00:00-04:00"), or a calendar date ("2026-10-01"), which starts at 00:00 UTC. A
date_to	string	no	Inclusive upper bound on created_at. An ISO 8601 date-time with Z or a UTC offset ("2026-10-01T09:00:00Z", "2026-10-01T09:00:00-04:00"), or a calendar date ("2026-10-01"), which runs to the end of tha
full	boolean	no	Set true for the record as stored. By default the result is a compact view for reading, which leaves out per-row delivery, webhook and classification state (message_id, domain and org ids, spam score,
api_key	string	no	Primitive API key (prim_...). Only needed when this connection has no signed-in account: pass the api_key returned by createEmailAddress, unchanged, on every call for the rest of the conversation. Omi

Find particular inbound emails. Use this when you are looking for specific messages: a full-text query (q) over subject, body, sender and recipient, or structured filters on sender, recipient, subject, body, attachments, spam score, or the sent email they reply to. Results can be ranked by relevance or date and carry a body snippet. To page through the inbox newest first, or to wait for mail that

Parameter	Type	Required	Notes
q	string	no	Full-text query matched across subject, body, sender, and recipient. Every word must match, so fewer words find more; put a phrase in double quotes. An upper-case OR between words, phrases, or subject
from	string	no	Filter to emails from this sender address or domain.
to	string	no	Filter to emails addressed to this recipient.
subject	string	no	Filter to emails whose subject contains this string.
body	string	no	Filter to emails whose body contains this string.
domain_id	string	no	Filter to emails received on a specific verified domain.
reply_to_sent_email_id	string	no	Filter to inbound emails that are replies to a specific sent email ID.
status	string	no	Filter to emails in this processing status.
date_from	string	no	Inclusive lower bound on received_at. An ISO 8601 date-time with Z or a UTC offset ("2026-10-01T09:00:00Z", "2026-10-01T09:00:00-04:00"), or a calendar date ("2026-10-01"), which starts at 00:00 UTC.
date_to	string	no	Inclusive upper bound on received_at. An ISO 8601 date-time with Z or a UTC offset ("2026-10-01T09:00:00Z", "2026-10-01T09:00:00-04:00"), or a calendar date ("2026-10-01"), which runs to the end of th
has_attachment	boolean	no	Filter to emails that have (true) or lack (false) attachments.
spam_score_lt	number	no	Filter to emails with a spam score strictly below this value.
spam_score_gte	number	no	Filter to emails with a spam score at or above this value.
sort	string	no	Sort order. Defaults to relevance when there is text to rank against (q, subject or body) and to received_at_desc otherwise; relevance without any such text is treated as received_at_desc. Use receive
cursor	string	no	Pagination cursor from a previous response's meta.cursor field.
limit	integer	no	Maximum number of emails to return (1 to 100, default 50).
snippet	boolean	no	Whether rows read with full: true carry highlighted match fragments for a text query (default true). The body snippet on each row is returned either way.
include_facets	boolean	no	Set true to also get aggregated facet counts (by sender, domain, status and whether there is an attachment) for the whole result set. Left out by default.
full	boolean	no	Set true for the record as stored. By default the result is a compact view for reading, which leaves out per-row delivery, webhook and classification state (message_id, domain and org ids, spam score,

Use this when you need to read one inbound email. Returns id, thread_id, received_at, from, to, subject, preheader, body_text and each attachment's filename, content type, size and part_index (read one with getEmailAttachment). body_text is the words of the email in reading order, without hidden content or the quoted history below a reply (counted in quoted_chars_removed). Each link is a [n] marke

Parameter	Type	Required	Notes
id	string	yes	Inbound email ID from listEmails or searchEmails.
full	boolean	no	Set true for the record as stored. By default the result is a compact view for reading, which leaves out the HTML body, link targets, quoted history, authentication results, routing and webhook delive
max_chars	integer	no	Most characters of body_text to return, 500 to 100000. Read the rest with offset. Not used with full.
offset	integer	no	Character position in the body to start from: the body_next_offset of the previous result. Not used with full.
links	string	no	Which link targets to return, as a links array of { n, url }: "all", or a comma-separated list of [n] numbers such as "3,7" (at most 50). Omit for none. Not used with full.
api_key	string	no	Primitive API key (prim_...). Only needed when this connection has no signed-in account: pass the api_key returned by createEmailAddress, unchanged, on every call for the rest of the conversation. Omi

Use this when the user has selected a specific inbound email and confirmed a reply. Sends real outbound email with threading handled server-side. When you expect an answer back, pass await_reply: true and it is returned in this same result.

Parameter	Type	Required	Notes
id	string	yes	Inbound email ID to reply to. Threading headers are set server-side.
await_reply	boolean	no	Set true when you expect an answer. After the send succeeds, this same call waits up to 30 seconds for the threaded reply and returns it as reply, with the outcome in reply_wait. If no reply arriv
body_text	string	no	Plain-text reply body. Provide at least one of body_text or body_html.
body_html	string	no	HTML reply body. Provide at least one of body_text or body_html.
from	string	no	Sender mailbox. Omit it to reply from the address the original message was sent to, which is almost always what you want.
wait	boolean	no	When true, wait for the first SMTP delivery outcome before returning.
attachments	array	no	Optional file attachments to include in the reply.
api_key	string	no	Primitive API key (prim_...). Only needed when this connection has no signed-in account: pass the api_key returned by createEmailAddress, unchanged, on every call for the rest of the conversation. Omi

Use this when the user has confirmed a new outbound email. Sends real email through Primitive's relay, or schedules it for a future time with scheduled_at. from is optional and defaults to your account's managed inbox address. When you expect an answer, pass await_reply: true and the reply comes back in this same result: most agent mailboxes answer within seconds, and the answer is usually what

Parameter	Type	Required	Notes
idempotency_key	string	no	Client-supplied idempotency key. Retrying with the same key returns the original result without re-sending. Without a key, an identical send (same content and recipients) inside the same 5-minute wind
await_reply	boolean	no	Set true when you expect an answer. After the send succeeds, this same call waits up to 30 seconds for the threaded reply and returns it as reply, with the outcome in reply_wait. If no reply arriv
from	string	no	Sender mailbox. Omit it to send from your account's managed inbox address, the sender_address that createEmailAddress and getAccount return. Set it only to send from another mailbox on a domain your a
to		yes	Recipient email address (RFC 5321 mailbox, display-name form allowed), or an array of single-address strings to address multiple recipients with one message. Each array entry must be exactly one addre
cc		no	Optional CC recipients: a single address or an array of single-address strings (each entry exactly one address). Counts toward the combined to+cc+bcc max of 100.
bcc		no	Optional BCC recipients: a single address or an array of single-address strings (each entry exactly one address). Counts toward the combined to+cc+bcc max of 100.
reply_to		no	Optional Reply-To header: a single address or an array of up to 10 single-address entries. A pure header: adds no recipients and does not count toward the recipient cap.
subject	string	yes	Email subject line.
body_text	string	no	Plain-text message body. Provide at least one of body_text or body_html.
body_html	string	no	HTML message body. Provide at least one of body_text or body_html. Reference inline attachments via cid: URLs matching their content_id.
in_reply_to	string	no	Message-ID of the email being replied to, for threading (e.g. "<abc@example.com>").
references	array	no	List of Message-IDs for the References header, oldest-first.
attachments	array	no	Optional file attachments. Not allowed on scheduled sends (scheduled_at).
tags	array	no	Optional metadata tags (max 10, unique names) stored on the send record for correlation and filtering via listSentEmails. Never rendered into headers and never delivered.
scheduled_at	string	no	Schedule the send for a future time (ISO 8601 with Z or a UTC offset, e.g. "2026-08-01T09:00:00Z"). Must be strictly in the future and at most 30 days out. Cannot be combined with wait or with attachm
wait	boolean	no	When true, wait for the first SMTP delivery outcome before returning. Respects wait_timeout_ms. Cannot be combined with scheduled_at.
wait_timeout_ms	number	no	How long to wait for delivery confirmation when wait is true (1000-30000 ms, default 10000).
api_key	string	no	Primitive API key (prim_...). Only needed when this connection has no signed-in account: pass the api_key returned by createEmailAddress, unchanged, on every call for the rest of the conversation. Omi

List outbound emails sent by this org, with cursor pagination and filters. Each row is id, thread_id, created_at, status, from, to, subject and a snippet, plus the error, SMTP response or gate denial when the send did not deliver. Use getSentEmail to read the body of one. Useful for auditing delivery status, finding bounced sends, or checking gate-denied attempts.

Parameter	Type	Required	Notes
cursor	string	no	Pagination cursor from a previous response's meta.cursor field.
limit	integer	no	Maximum number of sent emails to return (1 to 100, default 50).
status	string	no	Filter to rows in this status. Use "scheduled" to find pending scheduled sends and "canceled" for ones already canceled.
request_id	string	no	Filter to the row matching a specific server-issued request_id from a /send-mail response.
idempotency_key	string	no	Filter to rows with the given client idempotency key.
date_from	string	no	Inclusive lower bound on created_at. An ISO 8601 date-time with Z or a UTC offset ("2026-10-01T09:00:00Z", "2026-10-01T09:00:00-04:00"), or a calendar date ("2026-10-01"), which starts at 00:00 UTC. A
date_to	string	no	Inclusive upper bound on created_at. An ISO 8601 date-time with Z or a UTC offset ("2026-10-01T09:00:00Z", "2026-10-01T09:00:00-04:00"), or a calendar date ("2026-10-01"), which runs to the end of tha
full	boolean	no	Set true for the record as stored. By default the result is a compact view for reading, which leaves out idempotency and content hashes, message ids, signing details and, for a delivered row, the SMTP

Read a single sent email by id: status, from, to, subject, body_text and its attachments, plus the error, SMTP response or gate denial when the send did not deliver. Use to inspect delivery details for a specific send, such as the SMTP response on a bounced row or the gate denial reason on a gate_denied row. Pass full: true for the stored record, including body_html.

Parameter	Type	Required	Notes
id	string	yes	Sent email ID from listSentEmails or a /send-mail response.
full	boolean	no	Set true for the record as stored. By default the result is a compact view for reading, which leaves out the HTML body, quoted history, idempotency and content hashes, signing details and, for a deliv

Wait for the threaded reply to a sent email. Use it when a send was made without await_reply, or returned reply_wait.status "no_reply_yet". With only the sent email's id it long-polls for up to 30 seconds by default. Do not report that nobody replied or ask the user to check later until this call returns with no reply. Set wait=false only for a deliberate immediate poll. Matching uses reply thread

Parameter	Type	Required	Notes
id	string	yes	The sent email id to fetch the reply for (from a sendEmail/replyToEmail response).
wait	boolean	no	When true, long-poll until a reply arrives or wait_timeout_ms elapses. Defaults to true. Set false only for a single immediate poll.
wait_timeout_ms	number	no	How long to wait when wait=true (1000 to 30000 ms). Defaults to 30000.
api_key	string	no	Primitive API key (prim_...). Only needed when this connection has no signed-in account: pass the api_key returned by createEmailAddress, unchanged, on every call for the rest of the conversation. Omi

Read a whole conversation, with message bodies. Pass the id of any inbound email and get every message of its thread, inbound and outbound, oldest first, each with its text, a direction (inbound/outbound) and a derived role (inbound→user, outbound→assistant). This is the tool for finding out what was said. Each text is sized for reading: every link target is replaced by [link], and the quoted hist

Parameter	Type	Required	Notes
id	string	yes	ID of any inbound email in the conversation.
full	boolean	no	Set true for the record as stored. By default the result is a compact view for reading, which leaves out link targets, the quoted history each reply repeats and per-turn message ids and classification

Read ONE attachment of an email. A text attachment (plain text, CSV, JSON, XML, Markdown, calendar and similar) comes back as text; an HTML attachment comes back reduced to text; a PNG, JPEG, GIF or WebP image up to 1 MB comes back as an image; any other file comes back as base64 when it is 256 KB or smaller, and otherwise as its description with a statement that it is too large to return. PDF and

Parameter	Type	Required	Notes
id	string	yes	ID of the email the attachment belongs to.
part_index	integer	no	The attachment's part_index from the email's attachments list. Preferred over filename, which need not be unique.
filename	string	no	The attachment's filename, when part_index is not to hand. Matched exactly, then ignoring case.
source	string	no	Whether id is an inbound email (received, the default) or a sent email (sent).
offset	integer	no	For text: the character to start from. Use next_offset from the previous call to continue.
max_chars	integer	no	For text: the most characters to return in this call (default 20000, at most 100000).
api_key	string	no	Primitive API key (prim_...). Only needed when this connection has no signed-in account: pass the api_key returned by createEmailAddress, unchanged, on every call for the rest of the conversation. Omi

Get this user's Primitive managed inbox domain, creating the account on first use: no signup form, no password, no email verification, no browser. CALL THIS FIRST whenever you do not already have a Primitive API key and the user wants to send or receive email, instead of telling them to sign up or visit a website. On first use the REST response's address field is a domain such as pink-ram.primitiv

Parameter	Type	Required	Notes
terms_accepted		yes	Must be true. Creating the account accepts Primitive's terms of service (https://www.primitive.dev/terms); say so to the user rather than accepting silently on their behalf.
device_name	string	no	Optional label for where the account was created, e.g. "ChatGPT". Up to 80 characters once surrounding whitespace is removed. Shown to the user later so they can recognise this account.

Free

$0 forever

Every tool — any call limit is its publisher’s, not ours
No card, and mcprush charges nothing for it
Runs at its publisher’s own address — this marketplace is not in the path
Nothing to cap, because mcprush bills nothing

Nothing here is billable: mcprush charges nothing to install Email or to call it, at any volume.

Where are you running it?

Tool surface

Release history

Email MCP

What it does

Quickstart

Where are you running it?

Tool surface

What counts against your monthly calls

Release history

See also