# Novu MCP Server — Add Notifications to Any AI Agent

> The Novu MCP server gives AI agents native access to 23 notification tools — subscribers, workflows, triggers, notifications, integrations, and more. Works with Claude, Cursor, and any MCP-compatible client.

Canonical: https://website-new-git-cursor-remove-segment-analytics-46f9-novuhq.vercel.app/mcp

Markdown: https://website-new-git-cursor-remove-segment-analytics-46f9-novuhq.vercel.app/mcp.md

MCP Server

Connect any AI to Novu. Instantly.

A standardized bridge for MCP-compatible AI clients to Novu. Connect once, notify everywhere.

- [Install MCP now](<#how-it-works>)
- [Review the skill file](<https://github.com/novuhq/skills>)

## Trigger a workflow with your agent, and let Novu do the rest

### Connect your AI client

Add the Novu MCP Server to Cursor, Claude Code, ChatGPT, or any MCP client — sign in with your Novu account when prompted.

### Discover available tools

Your agent discovers 23 tools. Run whoami to confirm you're connected, then manage subscribers, workflows, triggers, and more.

### Novu delivers everywhere

Novu delivers across channels — in-app, email, SMS, push — with full observability.

```json
{
  "mcpServers": {
    "novu": {
      "url": "https://mcp.novu.co/"
    }
  }
}
```

Supported MCP clients shown on the page: Cursor, Codex, Claude Code, VS Code, Windsurf, GitHub Copilot, and ChatGPT.

## Paste any prompt into your MCP client to interact with Novu in natural language

- Run whoami to verify I'm authenticated and show my Novu region.
- List all failed chat notifications from the last 24 hours and show me the error details.
- Create a workflow that sends an order confirmation via email, an SMS with the tracking number, and an in-app notification through Novu Inbox.
- Check if my SendGrid and Twilio integrations are active.
- Trigger a workflow that sends an order confirmation via SendGrid email, and sends an SMS with the tracking number, and an in-app notification through Novu Inbox.
- Find subscriber user_789, mute their in-app channel, but keep email and push active.
- Pull all failed notifications across all channels in the past 24 hours and group them by provider and show me the error details.

## Every tool your agent needs to control notification infrastructure

### Auth

- whoami: Verify the current credential and show your identity and region

### Environments

- get_environments: List environments — use an _id as the environmentId parameter on other tools

### Subscriber management

- create_subscriber: Create a new subscriber with attributes like name, email, phone, and custom data
- get_subscriber: Retrieve a single subscriber by their subscriberId
- update_subscriber: Update an existing subscriber's attributes
- delete_subscriber: Delete a subscriber by their subscriberId
- find_subscribers: Search for subscribers using various query parameters

### Preferences

- get_subscriber_preferences: Get subscriber notification preferences for all channels
- update_subscriber_preferences: Update subscriber notification preferences for specific channels

### Workflow management

- create_workflow: Create a new workflow with comprehensive configuration including steps
- get_workflow: Get detailed information about a specific workflow
- get_workflows: Get all available workflows
- update_workflow: Update an existing workflow
- delete_workflow: Delete a workflow by its unique identifier

### Triggering & events

- trigger_workflow: Trigger a workflow to send notifications to a subscriber
- bulk_trigger_workflow: Trigger multiple workflows in a single API call
- cancel_triggered_event: Cancel a pending triggered event

### Notifications

- get_notification: Get a specific notification by ID with detailed execution logs
- get_notifications: Get notifications/events with advanced filtering options

### Integrations

- get_integrations: List all channel integrations (email, SMS, push, chat, in-app)
- get_active_integrations: List only the active integrations
- delete_integration: Delete an integration by its integrationId
- set_primary_integration: Mark an integration as the primary for its channel

[Read the docs](<https://docs.novu.co/platform/additional-resources/mcp>)

## Integrates seamlessly with leading agentic frameworks

- Claude
- Cursor
- ChatGPT
- Windsurf
- Copilot
- Codex
- VS Code

## Don’t just take our word for it...

Explore what developers and non-technical users say about why they're fans of our open-source notifications framework.

## Get involved: start, engage, contribute

- [Novu Cloud](<https://dashboard.novu.co/>): Embark on your journey by creating your personalized account
- [Join Discord](<https://discord.gg/novu?utm_campaign=website>): Immerse yourself in the community by joining our dedicated server
- [Fork and Work](<https://github.com/novuhq/novu/issues>): Discover an issue within our project and make a valuable contribution

## Start building with MCP

Connect your first AI agent in under 5 minutes.

[GET STARTED FREE](<https://dashboard.novu.co/>)

[READ THE DOCS](<https://docs.novu.co/platform/additional-resources/mcp>)