node-red-mcp
Provides tools for managing Node-RED flows, including getting, creating, updating, enabling, disabling flows, as well as searching and installing modules.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@node-red-mcpshow me my current flows"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
🚀 MCP Node-RED Server
A modern, production-ready Model Context Protocol (MCP) server for Node-RED integration.
🌟 Features
🔧 20 MCP Tools
Full CRUD for flows, context variables, modules, and diagnostics — plus semantic search and real-time error detection.
📚 Prompts Library
Built-in prompt templates: debug_flow, explain_automation, audit_security, document_flow.
📦 MCP Resources
Browse Node-RED state as structured resources: nodered://flows, nodered://subflows, nodered://nodes, nodered://context/global, flow://<id>, system://runtime.
🔍 Semantic Search
Embeddings-based search across flows and nodes via semantic_search_flows. Finds by meaning, not just keywords.
🧠 Elicitation
The server asks clarifying questions mid-call when required parameters are missing (MCP SDK 1.24+ elicitation).
🚨 Real-time Error Detection
get_node_errors connects to Node-RED's WebSocket /comms endpoint to detect nodes in error/warning state in real time.
Related MCP server: MCP Server for n8n Integration
📋 Table of Contents
⚡ Quick Start
Prerequisites
Node.js 22+ (LTS recommended)
Yarn 4.x (automatically managed via Corepack)
Docker (optional, for containerized setup)
Native Installation
git clone https://github.com/ziv-daniel/node-red-mcp.git
cd node-red-mcp
yarn install
yarn buildDocker
docker run -e NODERED_URL=http://your-nodered:1880 \
-e NODERED_USERNAME=admin \
-e NODERED_PASSWORD=password \
-p 3000:3000 \
ghcr.io/ziv-daniel/node-red-mcp:latest🔧 Available MCP Tools
Flow Management
Tool | Description | Key Parameters |
| List flows (summary or full) |
|
| Get a specific flow |
|
| Create a new flow |
|
| Update an existing flow |
|
| Enable a flow |
|
| Disable a flow |
|
| Delete a flow (dry-run by default) |
|
| Validate flow structure |
|
| Search nodes by type/name/property |
|
| Embeddings-based semantic search |
|
Context Variables
Tool | Description | Key Parameters |
| Read global or flow context |
|
| Write a context variable |
|
| Delete a context variable |
|
Modules
Tool | Description | Key Parameters |
| Search Node-RED palette |
|
| Install a module |
|
| List installed modules | — |
Diagnostics
Tool | Description | Key Parameters |
| Detect nodes in error/warning state (WebSocket) |
|
| Get flow runtime state (started/stopped) | — |
| Get Node-RED runtime settings | — |
| Get Node-RED version and system info | — |
📦 MCP Resources
Access Node-RED state as browseable MCP resources:
URI | Description |
| All tab flows (summary) |
| All subflows |
| Installed node modules |
| Global context variables |
| Full detail for a specific flow |
| Node-RED runtime info |
📚 MCP Prompts
Built-in prompt templates for common tasks:
Prompt | Description |
| Diagnose errors in a specific flow |
| Explain what a flow does in plain language |
| Security audit of flow configurations |
| Generate documentation for a flow |
🔌 Connecting to the Server
Transport Modes
Mode | Env Var | Endpoint | Use Case |
Streamable HTTP |
|
| Production, remote agents |
Stdio |
| stdin/stdout | Claude Desktop |
Authentication
Set MCP_USERNAME and MCP_PASSWORD for HTTP Basic Auth on the /mcp endpoint.
Claude Desktop (stdio)
{
"mcpServers": {
"nodered": {
"command": "node",
"args": ["path/to/node-red-mcp/dist/index.mjs"],
"env": {
"MCP_TRANSPORT": "stdio",
"NODERED_URL": "https://your-nodered-instance.com",
"NODERED_USERNAME": "admin",
"NODERED_PASSWORD": "password"
}
}
}
}Claude Code / Remote Agent (HTTP)
claude mcp add node-red \
--transport streamable-http \
--url https://<your-server>/mcp \
--header "Authorization: Basic <base64-credentials>"⚙️ Environment Variables
Variable | Required | Default | Description |
| Yes | — | URL of your Node-RED instance |
| No | — | Node-RED admin username |
| No | — | Node-RED admin password |
| No |
|
|
| No | — | MCP server auth username |
| No | — | MCP server auth password |
| No |
| Bind address |
| No |
| Listen port |
| No |
|
|
| No |
| Set |
| No |
| Model for semantic search |
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/ziv-daniel/node-red-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server