Primitive MCP server

This URL is an MCP server for AI assistants, not a web page. Add it to your assistant to read, search, send and reply to email with Primitive.

https://www.primitive.dev/mcp

Transport: Streamable HTTP. Authentication: OAuth, or a Primitive API key.

Claude

1. Open Settings → Connectors and choose Add custom connector.
2. Enter the server URL: https://www.primitive.dev/mcp
3. Sign in with your Primitive account and approve access.

ChatGPT

Install the Primitive app from the ChatGPT app directory, or add it as a custom connector:

1. Open Settings → Apps & Connectors (turn on Developer mode if custom connectors are not shown).
2. Create a connector with the URL https://www.primitive.dev/mcp
3. Sign in with your Primitive account and approve access.

Claude Code

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

Then run /mcp in a session and choose primitive to sign in.

Cursor

Add to Cursor, or add this to ~/.cursor/mcp.json:

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

Other clients

Codex:

codex mcp add primitive --url https://www.primitive.dev/mcp

VS Code:

code --add-mcp '{"name":"primitive","type":"http","url":"https://www.primitive.dev/mcp"}'

Most other clients read the same mcpServers entry shown for Cursor.

Authentication

Clients that support OAuth open a Primitive sign-in the first time they connect. There is nothing else to configure.

No account yet? Call the createEmailAddress tool. It needs no sign-in, creates a managed inbox and returns an api_key. Send that key as Authorization: Bearer <api_key>, or pass it as the api_key argument on tools that accept one.

Full guide: https://www.primitive.dev/docs/connectors. Machine-readable manifest: https://www.primitive.dev/mcp.json.