Node-RED MCP Server

MCP server for Node-RED workflow management. Provides AI assistants with tools to read, create, and update your Node-RED flows safely through the Admin API v2.

Installation

Claude Code

Standalone Node-RED:

claude mcp add node-red -e NODE_RED_URL=http://localhost:1880 -e NODE_RED_TOKEN=your-api-token -- npx mcp-node-red

Home Assistant Add-on (Basic Auth):

claude mcp add node-red -e NODE_RED_URL=http://username:password@homeassistant.local:1880 -- npx mcp-node-red

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or ~/.config/claude/claude_desktop_config.json (Linux):

{
  "mcpServers": {
    "node-red": {
      "command": "npx",
      "args": ["mcp-node-red"],
      "env": {
        "NODE_RED_URL": "http://localhost:1880",
        "NODE_RED_TOKEN": "your-api-token"
      }
    }
  }
}

Restart Claude Desktop to load the server.

Configuration

Environment Variables

• NODE_RED_URL (required): Your Node-RED instance URL
• NODE_RED_TOKEN (optional): API token for authentication

Node-RED Setup

Standalone Node-RED

1. Enable Admin API in Node-RED settings.js:

adminAuth: {
  type: "credentials",
  users: [{
    username: "admin",
    password: "$2a$08$...",  // bcrypt hash
    permissions: "*"
  }]
}

2. Generate API token:

curl -X POST http://localhost:1880/auth/token \
  -H "Content-Type: application/json" \
  -d '{"client_id":"node-red-admin","grant_type":"password","scope":"*","username":"admin","password":"your-password"}'

Home Assistant Add-on

The Home Assistant Node-RED add-on uses Basic Auth with your Home Assistant credentials:

# Test connection
curl http://USERNAME:PASSWORD@homeassistant.local:1880/flows

Configuration:

{
  "mcpServers": {
    "node-red": {
      "command": "npx",
      "args": ["mcp-node-red"],
      "env": {
        "NODE_RED_URL": "http://admin:your-ha-password@homeassistant.local:1880"
      }
    }
  }
}

Note: No NODE_RED_TOKEN needed - credentials are in the URL.

Features

• get_flows: Retrieve all flows from your Node-RED instance
• create_flow: Create new flows via POST /flow
• update_flow: Update individual flows via PUT /flow/:id
• validate_flow: Validate flow configuration without deploying

Usage

Once configured, ask your AI assistant natural language questions:

Get all flows from my Node-RED instance

Create a new flow with label "Temperature Monitor"

Update flow "flow1" to change its label to "New Name"

Validate this flow configuration: {...}

Safety Features

• Individual flow updates: Uses PUT /flow/:id to update only the specified flow
• No accidental deletions: Other flows remain completely untouched
• Validation: All flow configurations are validated before sending to Node-RED
• Read-only by default: Only modifies flows when explicitly requested

Development

See docs/development.md for development setup, testing, and contribution guidelines.

License

MIT