Skip to main content
MCP server CX Codex

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

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

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

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open