makafeli/n8n-workflow-builder
AI assistant integration for n8n workflow automation through Model Context Protocol (MCP). Connect Claude Desktop, ChatGPT, and other AI assistants to n8n for natural language workflow management.
534 ★125 forksJavaScriptUpdated 4mo ago
What you need to know
MCP server bridging AI assistants (Claude Desktop, Cline, ChatGPT) to n8n workflow automation — list, create, execute, activate/deactivate, update, delete workflows, manage executions and tags, and generate security audits, all through n8n's official API.
Install
npx @makafeli/n8n-workflow-builder Smithery.ai hosted version (no local setup) Manual: git clone + npm install + npm run build + npm start
Usage
- •Set N8N_HOST (e.g. http://localhost:5678) and N8N_API_KEY env vars
- •Add to claude_desktop_config.json with command npx @makafeli/n8n-workflow-builder and the env vars
- •Ask the assistant to list, create, execute, or audit workflows in natural language
- •Debug mode: DEBUG=n8n-workflow-builder npx @makafeli/n8n-workflow-builder
Key features
- ✓15 tools: list_workflows, get_workflow, create_workflow, execute_workflow, update_workflow, activate_workflow, deactivate_workflow, delete_workflow, create_workflow_and_activate, list_executions, get_execution, delete_execution, list_tags, create_tag, generate_audit
- ✓Full CRUD for n8n workflows via the official n8n API with proper authentication
- ✓Zero configuration with NPX; works with n8n Cloud or self-hosted instances
- ✓Execution management with filtering/pagination and tag management
- ✓Security audit report generation (abandoned workflows, credentials, database, nodes)
Best for
Teams using n8n who want to create, manage, and run workflows from AI assistants via natural language.
Caveats
- ⚠Requires Node.js 18+ and a running n8n instance with a valid n8n API key (permissions under your control)
- ⚠Requires network access from where the MCP server runs to the n8n instance
- ⚠No data is stored by the MCP server; communication is direct between assistant and n8n
Platforms: Windows · macOS · LinuxClients: Claude Desktop · Cline · Continue · ChatGPT · any MCP-compatible client
Documentation ↗Reviewed 2026-08-07
Topics
ai-assistantai-automationai-integrationapi-integrationapi-wrapperautomation-toolschatgpt-integrationclaude-desktoplow-codemcp-servermodel-context-protocoln8nno-codenodejsrest-apitypescriptwebhookworkflow-automationworkflow-management
- Stars
- 534★
- Forks
- 125
- Language
- JavaScript
- License
- MIT
- Created
- 2025-01-14
- Last push
- 2026-03-19