primitive.dev — Claude Code MCP server: what it does, how to install
primitive.dev connects AI assistants to email infrastructure for sending, parsing inbound mail, and tracking webhooks over HTTP.
no license 8,352 installs updated 2026-06-09
claude mcp add --transport http primitive https://primitive.run.toolsWhat primitive.dev does
This MCP server hooks into the Primitive HTTP interface at https://primitive.run.tools. It lets models inspect DNS records, verify custom domain ownership (including MX, SPF, DKIM, and DMARC settings), and read incoming mail. Models can parse message threads, retrieve compressed attachments, and poll for replies directly within conversations. A dedicated sendEmailDemo tool tests payload schemas without routing actual traffic.
It also covers webhook registration, delivery replays, and sender allowlists. Outbound messages will fail if the sender domain is unverified; running getOutboundStatus first confirms which addresses can actually send. Domain-specific inbound filter rules require a Pro plan subscription.
What it helps with
- Receive and parse inbound messages within agent workflows
- Verify DNS records for custom email routing
- Send threaded emails and await incoming replies
- Download message attachments packed as base64 archives
Example prompts for the agent
- Check inbox status and list verified domains
- Retrieve the full conversation thread for the latest incoming email
- Send a simulated message using sendEmailDemo
How to install primitive.dev
Platform CLI: remote server
claude mcp add --transport http primitive https://primitive.run.toolsPlatform CLI: remote server
codex mcp add primitivedev --url https://primitive.run.toolsConfig file
{
"mcpServers": {
"primitivedev": {
"url": "https://primitive.run.tools"
}
}
}Config file
{
"servers": {
"primitivedev": {
"type": "http",
"url": "https://primitive.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http primitivedev https://primitive.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about primitive.dev
How to install primitive.dev in Claude Code?
Run claude mcp add --transport http primitive https://primitive.run.tools in your terminal. It connects via HTTP to the remote endpoint.
What does the primitive.dev MCP server do?
It equips coding assistants with tools to send outbound emails, fetch inbound messages, configure webhook endpoints, and inspect DNS verification.
What is required before sending outbound emails?
You must verify your domain records first and check eligibility using getOutboundStatus, because unverified domains cannot dispatch messages.