Skip to content
Novu logoNovu

Manage agents and conversations through the Novu MCP server

Create and update agents, connect channels, and inspect conversation activity from any MCP-compatible AI tool.

Cover image for Manage agents and conversations through the Novu MCP server
Contributors
  • Nikita Grossman

    Nikita Grossman

  • Victor Yakubu

    Victor Yakubu

Details

Agent and conversation tools are now available on the Novu MCP server. You can manage the conversational side of Novu from the same AI tool you use to create workflows, inspect subscribers, and troubleshoot notification delivery.

Ask your assistant to create or update an agent, connect a channel, list recent conversations, or inspect the activity timeline for a specific thread. Together with the existing workflow tools, you can also assign agents to existing workflows without switching between your editor and the Novu Dashboard.

Create and configure agents from a prompt

The new agent tools cover the core setup and management flow:

ToolWhat it does
create_agentCreates a Novu agent.
get_agentsLists agents with cursor-based pagination.
get_agentRetrieves one agent by its public identifier.
update_agentUpdates an agent's name, status, bridge URL, or behavior.
connect_agentConnects a channel to an existing agent.

For example, you can ask:

Create a managed Novu agent called Support Bot that answers product questions briefly, then connect Slack to it.

Your AI tool discovers the required Novu operations and calls them in sequence. Agent tools use the agent's public identifier, such as support-bot, rather than its internal database ID.

Inspect conversations where you build

Two conversation tools bring agent debugging into the same workflow:

  • get_conversations lists agent conversations and supports optional filters.
  • get_conversation_activities returns the activity timeline for a conversation.

You can move from an agent to its latest conversation and inspect the full thread activity with one prompt:

Show recent conversations for the support-bot agent, then inspect the activity timeline for the latest one.

This makes it easier to investigate a failed turn, review what happened around a tool approval, or trace a conversation back to its channel without starting in the Dashboard.

Use the tools in the right environment

OAuth connections default to the Development environment. Ask the assistant to list your environments, then pass the target environment when you need to work in Production or another environment. API keys remain scoped to the environment they belong to.

The account-management MCP server is available for Novu Cloud at:

  • US: https://mcp.novu.co/
  • EU: https://eu.mcp.novu.co/

OAuth is the recommended authentication method for interactive clients. A Novu Cloud API key is available as a fallback for clients that do not support OAuth.

The hosted endpoints do not connect to self-hosted Novu installations. The conversation tools also require Novu Cloud with Conversations enabled.

Connect the Novu MCP server to Cursor, Claude Code, ChatGPT, VS Code, Codex, or another MCP-compatible tool to get started.