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
View on GitHub ↗
Stars
534★
Forks
125
Language
JavaScript
License
MIT
Created
2025-01-14
Last push
2026-03-19