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

{
  "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
Connect your AI client
Point any MCP client — Claude, Cursor, or your app — to the Novu MCP Server.
2
Discover available tools
Your agent finds 23 tools: subscribers, preferences, workflows, triggers, notifications, integrations, and environments.
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

Read the docs

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.

Get involved: start, engage, contribute

Novu Cloud
Embark on your journey by creating your personalized account
Get started
Join Discord
Immerse yourself in the community by joining our dedicated server
Join Discord
Fork and Work
Discover an issue within our project and make a valuable contribution
Find an issue