courier-mcp — Claude Code MCP server: setup
This MCP server lets AI agents work with Courier for notifications, user profiles, lists, and delivery checks. Use it when Courier operations should run from an agent.
no license 312 installs updated 2026-04-02
claude mcp add --transport http courier-mcp https://courier-mcp--courier.run.toolsWhat courier-mcp does
courier-mcp exposes the Courier notification API to an AI agent over MCP. It can send and inspect messages, read rendered content, review delivery events, cancel an in-flight message, and manage user profiles, lists, audiences, and brands.
The server provides 60 tools built on the @trycourier/courier Node SDK. It also covers automation runs, audit events, bulk delivery jobs, inbound events, and SDK setup guidance. A bulk send follows create_bulk_job, add_bulk_users, then run_bulk_job; client-side SDK guidance can include a sample JWT.
The remote HTTP endpoint is https://courier-mcp--courier.run.tools. An inbound event needs an event name, messageId for deduplication, and event properties, so track_inbound_event cannot run with only a trigger name.
What it helps with
- send notifications through Courier
- inspect a message’s delivery trail
- maintain users and list subscriptions
- run a bulk delivery job
- trigger an automation from an inbound event
Example prompts for the agent
- Check the delivery history for message ID
messageId. - Create a bulk job, add the selected users, and run it.
- Trigger an automation with event name
eventName,messageId, and the supplied properties.
How to install courier-mcp
Platform CLI: remote server
claude mcp add --transport http courier-mcp https://courier-mcp--courier.run.toolsPlatform CLI: remote server
codex mcp add courier-courier-mcp --url https://courier-mcp--courier.run.toolsConfig file
{
"mcpServers": {
"courier-courier-mcp": {
"url": "https://courier-mcp--courier.run.tools"
}
}
}Config file
{
"servers": {
"courier-courier-mcp": {
"type": "http",
"url": "https://courier-mcp--courier.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http courier-courier-mcp https://courier-mcp--courier.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 courier-mcp
How do I install courier-mcp in Claude Code?
Run these commands in order: claude mcp add --transport http courier-mcp https://courier-mcp--courier.run.tools, then claude mcp add --transport http courier-courier-mcp https://courier-mcp--courier.run.tools.
What does courier-mcp do?
It connects an AI agent to the Courier API through MCP. The available tools cover notifications, profiles, lists, automations, bulk jobs, and delivery diagnostics.
What does track_inbound_event require?
The call needs an event name, a messageId used for deduplication, and event properties. The event can start an automation.