primitive

by primitivedotdev

3 stars

235 downloads

Not rated

GitHub Website

Other

About

Official Node.js, Python, and Go SDKs plus the primitive CLI for Primitive — email infrastructure for AI agents. Generated from the OpenAPI spec.

Details

Author: primitivedotdev
GitHub stars: 3
Downloads: 235
Categories: Other

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name primitive

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "primitive": {
            "primitive": {
                "url": "https://www.primitive.dev/mcp",
                "headers": {
                    "Authorization": "Bearer prim_YOUR_API_KEY"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "primitive": {
            "primitive": {
                "url": "https://www.primitive.dev/mcp",
                "headers": {
                    "Authorization": "Bearer prim_YOUR_API_KEY"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "primitive": {
            "primitive": {
                "url": "https://www.primitive.dev/mcp",
                "headers": {
                    "Authorization": "Bearer prim_YOUR_API_KEY"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "primitive": {
            "primitive": {
                "url": "https://www.primitive.dev/mcp",
                "headers": {
                    "Authorization": "Bearer prim_YOUR_API_KEY"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "primitive": {
            "primitive": {
                "url": "https://www.primitive.dev/mcp",
                "headers": {
                    "Authorization": "Bearer prim_YOUR_API_KEY"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "primitive": {
            "primitive": {
                "url": "https://www.primitive.dev/mcp",
                "headers": {
                    "Authorization": "Bearer prim_YOUR_API_KEY"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "primitive": {
            "primitive": {
                "url": "https://www.primitive.dev/mcp",
                "headers": {
                    "Authorization": "Bearer prim_YOUR_API_KEY"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "primitive": {
            "primitive": {
                "url": "https://www.primitive.dev/mcp",
                "headers": {
                    "Authorization": "Bearer prim_YOUR_API_KEY"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "primitive": {
            "primitive": {
                "url": "https://www.primitive.dev/mcp",
                "headers": {
                    "Authorization": "Bearer prim_YOUR_API_KEY"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "primitive": {
            "primitive": {
                "url": "https://www.primitive.dev/mcp",
                "headers": {
                    "Authorization": "Bearer prim_YOUR_API_KEY"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "primitive": {
            "primitive": {
                "url": "https://www.primitive.dev/mcp",
                "headers": {
                    "Authorization": "Bearer prim_YOUR_API_KEY"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "primitive": {
            "primitive": {
                "url": "https://www.primitive.dev/mcp",
                "headers": {
                    "Authorization": "Bearer prim_YOUR_API_KEY"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "primitive": {
            "primitive": {
                "url": "https://www.primitive.dev/mcp",
                "headers": {
                    "Authorization": "Bearer prim_YOUR_API_KEY"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "primitive": {
            "primitive": {
                "url": "https://www.primitive.dev/mcp",
                "headers": {
                    "Authorization": "Bearer prim_YOUR_API_KEY"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "primitive": {
            "primitive": {
                "url": "https://www.primitive.dev/mcp",
                "headers": {
                    "Authorization": "Bearer prim_YOUR_API_KEY"
                }
            }
        }
    }
}

From the repository

Install the SDK for your language (npm install @primitivedotdev/sdk, pip install primitivedotdev, or go get github.com/primitivedotdev/sdks/sdk-go@latest). Use receive(...) to parse an incoming email, client(...) to create an outbound client with an API key, and then send(...), reply(...), or forward(...) to act on the email.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "primitive": {
            "primitive": {
                "url": "https://www.primitive.dev/mcp",
                "headers": {
                    "Authorization": "Bearer prim_YOUR_API_KEY"
                }
            }
        }
    }
}

McpServers

{
    "primitive": {
        "url": "https://www.primitive.dev/mcp",
        "headers": {
            "Authorization": "Bearer prim_YOUR_API_KEY"
        }
    }
}

Primitive SDKs

Monorepo for the Primitive SDKs.

Primitive is an inbound and outbound email platform. The SDKs are centered on a
small default workflow:

1. receive an inbound email
2. inspect a normalized email object
3. send, reply, or forward synchronously

SDKs

| SDK | Install target | README |
| --- | --- | --- |
| Node.js | npm install @primitivedotdev/sdk | sdk-node/README.md |
| Python | pip install primitivedotdev | sdk-python/README.md |
| Go | go get github.com/primitivedotdev/sdks/sdk-go@latest | sdk-go/README.md |

Default API shape

Across the SDKs, the default story is:

- receive inbound mail with receive(...)
- create an outbound client with client(...)
- send new mail with send(...)
- continue a thread with reply(...)
- forward a message with forward(...)

The Node.js end-state looks like this:

import primitive from "@primitivedotdev/sdk";
const client = primitive.client({

  apiKey: process.env.PRIMITIVE_API_KEY!,

});
export async function POST(req: Request) {

  const email = await primitive.receive(req, {

    secret: process.env.PRIMITIVE_WEBHOOK_SECRET!,

  });
await client.reply(email, "Thank you for your email.");
return Response.json({ ok: true });

}

x402 payments

Each SDK also ships a non-custodial x402 payments client. One agent registers a
payout address and requests a USDC payment; the paying agent signs locally with
its own key and settles. Keys never leave the caller. Networks are base and
base-sepolia, and amounts are token base units (USDC has 6 decimals, so
"10000" is 0.01 USDC). See the "x402 payments" section in each SDK README
(sdk-node, sdk-python, sdk-go) for runnable examples, and the
primitive payments command group in the CLI for the same flow from a terminal.

Advanced surfaces

The low-level and generated APIs still exist for advanced use cases:

- webhook verification/parsing helpers
- generated HTTP API packages
- Primitive Memories key-value operations
- OpenAPI exports
- contract tooling
- raw MIME parsing helpers
- CLI

The SDK refresh keeps those escape hatches available, but the primary docs story
focuses on the inbound/outbound automation flow above.

Repository layout

sdks/
  .github/workflows/
  openapi/
  json-schema/
  sdk-go/
  sdk-node/
  sdk-python/
  test-fixtures/

Development

Use the root Makefile as the main task interface:

make node-generate python-generate go-generate
make check
make build
make shared-check

The Makefile wraps each SDK's native commands. You can still run them directly
from each SDK directory when needed:

cd sdk-node && pnpm typecheck && pnpm test
cd sdk-python && uv sync --dev && uv run pytest && uv run ruff check . && uv run basedpyright
cd sdk-go && go test ./... && go test -run TestSharedCompatibilityFixtures ./...

Documentation

- docs/architecture.md gives the repository architecture and package layout
- docs/schema-generation.md documents schema/codegen flow
- docs/repo-model.md documents the monorepo task model
- RELEASE.md documents the release process

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Primitive SDKs

SDKs

Default API shape

x402 payments

Advanced surfaces

Repository layout

Development

Documentation

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Reactive Resume

FastMCP v2 🚀