primitive
app

Primitive AI platform integrations

primitive.dev gives AI agents a real email identity. It connects to the major agent platforms through open, machine-readable manifests — so an agent on any of these platforms can discover and use Primitive without a custom integration.

ChatGPT

Primitive publishes a standard plugin manifest describing the product, its OpenAPI spec, and how a model should use it. Point a ChatGPT-compatible runtime at the manifest to let it send and receive email through Primitive.

Codex

Primitive ships a Codex plugin that bundles the hosted MCP server with every Primitive skill: chat, inbox, send, connect, network, functions, webhooks and domains. Add the marketplace and install it to give the Codex agent email tools (send, receive, search, and reply) in one step.

codex plugin marketplace add primitivedotdev/skills
codex plugin add primitive@primitive
codex mcp login primitive

Claude

Primitive runs a hosted Model Context Protocol (MCP) server. Add it as a connector in Claude (claude.ai, Claude Desktop, or Claude Code) to give Claude the Primitive email tools — list, search, read, send, and reply. Auth is OAuth; a credential-free demo tool lets Claude try a send before you connect an account.

In Claude Code, add the server with one command, then run /mcp to sign in:

claude mcp add --transport http primitive https://www.primitive.dev/mcp

Or install the Claude Code plugin, which bundles the server with the Primitive skills:

claude plugin marketplace add primitivedotdev/skills
claude plugin install primitive@primitive

Any MCP-compatible agent

Because the integration is a standard MCP server, any MCP-aware client can use it — not just one vendor. The server is also listed in public MCP registries so agents can discover it by name. Discovery lives at a predictable URL.

Coding agents

For coding agents — Claude Code, Codex, Cursor, and 50+ compatible agents — the primitive-chat and primitive-inbox skills install in one command and are published on skills.sh under primitivedotdev/skills.

npx skills add primitivedotdev/skills

Editors & desktop agents

Any editor or desktop agent that speaks MCP can add Primitive as a server and get the same email tools — no plugin to publish, no SDK to wire up:

  • VS Code — in Copilot agent mode, add Primitive as an MCP server (https://www.primitive.dev/mcp) so the editor agent can send, receive, and reply to email from your workspace.
    code --add-mcp '{"name":"primitive","type":"http","url":"https://www.primitive.dev/mcp"}'
  • Cursor — register the Primitive MCP server in Cursor's MCP settings to give the Cursor agent the same email tools. Add to Cursor →
  • Goose — add Primitive as an MCP extension in Goose (Block's open-source agent) to let it send and wait for email replies.
  • Claude.ai & Claude Desktop — add Primitive as a connector, as described above.

Codex without the plugin: codex mcp add primitive --url https://www.primitive.dev/mcp, which opens the sign-in as part of the add. Any other client that reads an mcpServers file takes this entry:

{
  "mcpServers": {
    "primitive": {
      "url": "https://www.primitive.dev/mcp"
    }
  }
}

Build a custom integration

Every integration above is built on the same open surface: the developer resources, the OpenAPI spec, and the hosted MCP server. There is nothing platform-specific to reverse-engineer — discover the surface and call it.