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"
      }
    }
  }
}

Connect your AI client

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

Discover available tools

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

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
"Novu is so dope!" - Lev Lazinskiy@levlaz
"Thanks to a great tool called @novuhq, we can easily implement notifications into our upcoming v0.5.0 release." - Doinfine@doinfinehq
"New @middayai engineering blog post just dropped. Learn how we are using @novuhq as our notification infrastructure. Link in thread 🧵⬇️" - Pontus Abrahamsson@pontusab
"So excited about the rise of the notifications infrastructure space (+ open source 🔥)" - Guillermo Rauch@rauchg
"Haha yeah I’m so happy my notification logic isn’t inside the database anymore. Love Novu!🚀" - Fabian B.@madebyfabian

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

Start building with MCP

Connect your first AI agent in under 5 minutes.

GET STARTED FREE READ THE DOCS