# courier-mcp

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 312 installs
- Author: courier
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/courier/courier-mcp
- Updated: 2026-04-02
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/courier-courier-mcp

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

## Requirements
- Remote server: `https://courier-mcp--courier.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http courier-mcp https://courier-mcp--courier.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add courier-courier-mcp --url https://courier-mcp--courier.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "courier-courier-mcp": {
            "url": "https://courier-mcp--courier.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "courier-courier-mcp": {
            "type": "http",
            "url": "https://courier-mcp--courier.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http courier-courier-mcp https://courier-mcp--courier.run.tools
```

## When to use it
- 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
- 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.

## Similar
- [Courier MCP](https://affpapa.org/en/nevibecode/mcp/courier-mcp.md) — MCP server · 888 installs
- [OneSignal](https://affpapa.org/en/nevibecode/mcp/onesignal.md) — MCP server · 22491 installs
- [pendnt](https://affpapa.org/en/nevibecode/mcp/pendnt.md) — MCP server
- [Zoro](https://affpapa.org/en/nevibecode/mcp/zoro.md) — MCP server · 138 installs
- [google-chat-messages](https://affpapa.org/en/nevibecode/skills/google-chat-messages.md) — skill · 1300 installs
- [gws-chat-send](https://affpapa.org/en/nevibecode/skills/gws-chat-send.md) — skill · 33100 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
