Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http primitive https://primitive.run.tools
Open on GitHub

What 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.tools

Step 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.

Similar MCP servers

All MCP servers for Backend and APIs →

Project sponsors

Companies that keep this analytics open