# MCP Server

## Connect any AI to Novu. Instantly.

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

## How it works

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

```json
{
  "mcpServers": {
    "novu": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.novu.co/",
        "--header",
        "Authorization: Bearer ${NOVU_API_KEY}"
      ],
      "env": {
        "NOVU_API_KEY": "your-novu-api-key-here"
      }
    }
  }
}
```

1. 1

### Connect your AI client

Point any MCP client — Claude, Cursor, or your app — to the Novu MCP Server.

2. 2

### Discover available tools

Your agent finds 23 tools: subscribers, preferences, workflows, triggers, notifications, integrations, and environments.

3. 3

### Novu delivers everywhere

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

## Prompts

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

- “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.”

## Agentic tools

### Every tool your agent needs to control notification infrastructure

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

**Other**
- `get_environments`: Get all environments with their details and API keys.
- `get_api_key_status`: Check the current API key status and server region configuration.

## Integrates seamlessly with leading agentic frameworks

- 
- 
- 
- 
- 
-

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

- "That's awesome! Real-time notifications can really boost user engagement. Love that @novuhq supports multiple frameworks & customization options. Definitely giving the repo a star to show support! 🌟 #OpenSource #SoftwareDevelopment" - [Abhiuday@aeswibon](https://x.com/aeswibon/status/1696467646429147200)

- "Novu is so dope!" - [Lev Lazinskiy@levlaz](https://x.com/levlaz/status/1810734219330736300)

- "Thanks to a great tool called @novuhq, we can easily implement notifications into our upcoming v0.5.0 release." - [Doinfine@doinfinehq](https://twitter.com/doinfinehq/status/1671123804049874947)

- "New @middayai engineering blog post just dropped. Learn how we are using @novuhq as our notification infrastructure. Link in thread 🧵⬇️" - [Pontus Abrahamsson@pontusab](https://x.com/pontusab/status/1785312430882714031)

- "So excited about the rise of the notifications infrastructure space (+ open source 🔥)" - [Guillermo Rauch@rauchg](https://twitter.com/rauchg/status/1557048605042565120)

- "Haha yeah I’m so happy my notification logic isn’t inside the database anymore. Love Novu!🚀" - [Fabian B.@madebyfabian](https://x.com/madebyfabian/status/1603010122451746816)

## Get involved: start, engage, contribute

### Novu Cloud

Embark on your journey by creating your personalized account

[Get started](https://dashboard.novu.co/)

### Join Discord

Immerse yourself in the community by joining our dedicated server

[Join Discord](https://discord.gg/novu?utm_campaign=website)

### Fork and Work

Discover an issue within our project and make a valuable contribution

[Find an issue](https://github.com/novuhq/novu/issues)

## 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)