Ship production-ready notifications with Claude Code

Overview

How Claude Code and Courier fit together

Claude Code is Anthropic's coding agent for the terminal. With the Courier skill installed, it builds your notification system in your codebase, templates with fallback routing, journeys, preferences, and an in-app inbox, following Courier's patterns for each channel. Courier then makes sure those messages reach people: it picks the channel, falls back when one fails, respects the user's preferences, and shows you what happened.

The skill does the building. Add the hosted MCP server when you want to test against your account from the editor. Because Claude Code lives in the terminal, the plugin, the CLI, and the MCP server all sit in one session; a single claude mcp add with --scope user covers every project.

You need a Courier account. The skill needs nothing else; the MCP server needs a test-environment API key, which is separate from production.

What you can build

What you get with Claude Code + Courier

Agent skills

Patterns it reads before it writes

One install. Claude Code opens the skill's router, loads the one or two guides a task needs, and writes sends that follow the rules for that channel: OTP expiry, fallback order, idempotency keys, rate limits.

Templates

Templates with fallback routing

Ask for a password-reset flow with SMS first and email fallback and it builds the template and the routing, in your repo, from one prompt.

Courier Inbox

An in-app inbox in your app

Scaffold the Inbox component into a React or Next.js app and issue the user JWT server-side. The skill's inbox guides carry the auth and rendering patterns.

Journeys

Journeys with delays and branches

Build a multi-step onboarding journey with a two-day delay between steps, then publish it and run it for a test user.

Preferences

Preference topics users can opt out of

Create a preference section and topic, publish them, and wire your templates to respect the opt-out.

MCP

Test and prototype over MCP

Add the hosted server and Claude Code can create a template in your test workspace, send you a test, and pull the delivery events, so you see the message reach someone before you ship. 144 tools, one config block to add.

Use cases

What to build in your first session

→Add password-reset notifications to this app with Courier: SMS first, email fallback

→Add Courier Inbox to this Next.js app with a server-issued JWT

→Build a three-step onboarding journey with a two-day delay between steps

→Add a Product updates preference topic users can opt out of, and make onboarding respect it

Setup

Set up Claude Code with Courier

Two steps to build. Two more if you want to test against your account from the editor.

Install the Courier plugin

Adds Courier Skills to Claude Code. Run /plugin update courier@courier-skills later to pick up new guides.

/plugin marketplace add trycourier/courier-skills
/plugin install courier@courier-skills

Kick off a build

Claude Code reads the skill's router, loads the guides for the task, and writes the code and templates in your repo.

› Add password-reset notifications to this app with Courier:
  SMS first, email fallback

Add the MCP server to test and prototype

Optional. Needs your test-environment API key from app.courier.com/settings/api-keys. To confirm the key works, ask it to list your notification templates; a wrong key returns a 403. Add --scope user to share it across projects.

claude mcp add --transport http courier https://mcp.courier.com \
  --header api_key:YOUR_COURIER_API_KEY

Send yourself a test

Over MCP, Claude Code publishes the template to your test workspace, sends to your test user, and reads back the delivery events.

› Publish the password-reset template and send me a test

FAQ

Frequently asked questions

What does the Courier skill add?

A routing file plus about 40 reference guides covering seven channels, transactional and growth patterns, routing, reliability, and Inbox. Claude Code reads the router first and loads only the one or two guides a task needs. It is plain Markdown on the open agent-skills convention, so the same skill works in every tool that reads a SKILL.md.

Do I need the MCP server?

Not to build. The skill is enough for Claude Code to write templates, routing, journeys, and Inbox code in your repo. Add the MCP server when you want to test and prototype against your Courier account from the editor: publish to your test workspace, send yourself a test, read the delivery events.

What can Claude Code do through the Courier MCP server?

The hosted server exposes 144 tools covering the full Courier API: create and publish templates, define routing strategies, build and run journeys, set up preference topics and brands, manage users and lists, send test messages, and read message logs. It authenticates with your API key passed as a header; nothing runs locally.

Project scope or user scope for the MCP server?

claude mcp add registers the server for the current project by default. Add --scope user to make it available in every project on your machine.

Is it safe to let it work against my account?

Use the test-environment API key. Test and production keys are separate, so templates, journeys, and test sends stay in the test environment and never reach real users. Switch to the production key when you ship.

How is this different from the Claude and ChatGPT integrations?

Those cover AI assistants: Claude the model inside Courier (AI agent node, AI Translation) and connecting a ChatGPT agent to Courier. This page is Claude Code, the coding tool, building your notification system in your codebase with the Courier skill.