spences10/mcp-n8n-builder

🪄 MCP server for programmatic creation and management of n8n workflows. Enables AI assistants to build, modify, and manage workflows without direct user intervention through a comprehensive set of tools and resources for interacting with n8n's REST API.

84 ★26 forksTypeScriptUpdated 24d ago

What you need to know

MCP server for programmatic creation and management of n8n workflows via n8n's REST API, with Zod input/output validation and node-type validation with smart suggestions.

Install

npx -y mcp-n8n-builder
Add {"command":"npx","args":["-y","mcp-n8n-builder"],"env":{"N8N_HOST":"http://localhost:5678/api/v1","N8N_API_KEY":"your-n8n-api-key"}} to mcpServers

Usage

•list_available_nodes before creating or updating workflows
•list_workflows to find workflows by name/tags/active status
•create_workflow / update_workflow / activate_workflow / deactivate_workflow
•list_executions / get_execution for run history

Key features

✓Full workflow CRUD plus activate/deactivate
✓Execution history listing and retrieval
✓Zod validation of inputs and outputs
✓Node-type validation against the n8n instance with suggestions for similar nodes
✓Filtering by name, tags, or active status
✓OUTPUT_VERBOSITY control (concise/full) with per-tool verbosity override

Best for

n8n users who want AI assistants to build, inspect, and manage workflows programmatically

Caveats

⚠Officially labeled a token monster: n8n workflows are complex JSON structures that can consume thousands of tokens
⚠Use list_workflows and concise verbosity first to keep token costs low
⚠update_workflow requires the entire workflow structure
⚠Delete is permanent and cannot be undone

Platforms: macOS · Linux · WindowsClients: Claude Desktop · Cline

Documentation ↗

Reviewed 2026-08-11

Topics

ai-toolsmcpmodel-context-protocoln8n workflow-automation

Stars: 84★
Forks: 26
Language: TypeScript
License: MIT
Created: 2025-04-01
Last push: 2026-08-12