Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

The Novu MCP Server is a fully managed Cloudflare Worker that gives AI assistants access to the Novu notification platform. It lets any MCP-compatible client fetch events, manage subscribers, trigger workflows, and adjust preferences directly.

How to use Remote MCP Server on Cloudflare?

Point your MCP client to one of two regional endpoints: US (https://mcp.novu.co/) or EU (https://eu.mcp.novu.co/). Authenticate via OAuth (recommended, supported by Cursor, Claude, Windsurf, etc.) or by supplying a Novu API key as a Bearer token. For stdio‑only clients or self‑hosted Novu, use the mcp-remote proxy with an Authorization header.

Key features of Remote MCP Server on Cloudflare

• Fetch and filter notifications with full execution logs
• Search and manage subscribers by email, phone, name, or ID
• List, inspect, create, update, and trigger notification workflows
• Read and update subscriber channel preferences per workflow
• View environment configuration and manage provider integrations
• Authenticate via OAuth (Cloud only) or API key (Cloud or self‑hosted)

Use cases of Remote MCP Server on Cloudflare

• Trigger a notification workflow from a chat conversation
• Look up a subscriber’s delivery status and channel preferences
• List recent events and inspect why a notification failed
• Manage multiple environments (development, production) from a single AI client

FAQ from Remote MCP Server on Cloudflare

How does authentication work?

The server supports OAuth (recommended) and API key auth. With OAuth, the MCP client opens a Novu sign‑in and consent screen on first connection. With an API key, the key is provided as a Bearer token and the OAuth flow is skipped.

Can I use this with a self‑hosted Novu instance?

Yes. Self‑hosted deployments always use an API key (OAuth is Novu Cloud only). Point the MCP server at your local Novu API by setting NOVU_API_URL in .dev.vars and running the worker locally.

Do I need to host anything?

No. The hosted endpoints are fully managed on Cloudflare Workers. You only need to host yourself if you run a self‑hosted Novu instance or want a custom deployment.

Is there a limitation on which MCP clients work?

The server uses the Streamable HTTP MCP transport. Any client that supports remote MCP servers (Cursor, Claude, ChatGPT, Windsurf, etc.) can connect. For stdio‑only clients, use the mcp-remote proxy.

How are environments handled?

With an API key the key itself pins the environment. With OAuth the session defaults to the Development environment, but every tool accepts an