Vibeleaderboard
Index / tool
Visit github.com
Category
AI Agents
Rank
No. 1583Tools index
Pricing
Open Source
Type
TOOL
GitHub
132 stars
Date

About

MCP server that lets Claude Code build and manage n8n automation workflows directly.

What it does

This repository is an orchestration kit for developing n8n automations through a staged agent process. An architect maps data flows and validation points, then a builder implements the blueprint incrementally. Supporting agents test MCP behavior, exercise webhook endpoints, and diagnose failures. Docker Compose supplies a local n8n instance and its MCP bridge.

Why it's ranked here

The project offers more than a thin connection configuration. It defines clear roles, incremental build checkpoints, workflow validation, webhook testing, diagnostics, and action logging. That operational structure makes it useful for disciplined automation work. However, much of the value lives in detailed agent instructions rather than independently tested application code.

What's good

The architect and builder roles separate design choices from implementation. The builder validates small groups of nodes and favors partial workflow updates, which limits the scope of failures. Dedicated agents cover MCP testing and webhook checks. Hooks record tool activity, while helper scripts format or clear those logs. The local stack preserves n8n data between runs.

Tradeoffs

Setup depends on Docker, Docker Compose, an n8n API key for management features, and Claude Code agent conventions. Without the API key, only documentation and node search tools remain available. The supplied MCP example contains a machine-specific local path and placeholder credentials. Workflow validation still requires using the n8n interface before export. The repository text provides no license information or conventional automated test suite.

How to use it well

Use it when a team wants Claude Code to design, build, validate, and observe n8n workflows through explicit handoffs. Start with complete data, processing, control, and failure requirements. Let the architect define checkpoints before the builder changes anything. Keep exported workflows and operational notes together, then verify behavior in n8n. It does not replace n8n itself, credential provisioning, or testing of every external service.

Technical notes+

docker-compose.yml defines n8nio/n8n:latest on port 5678 and ghcr.io/czlonkowski/n8n-mcp:latest on the same bridge network, passing N8N_API_KEY and an internal API URL to the MCP container. scripts/start_servers.sh checks Docker and Compose, optionally stores the API key with mode 600, starts the stack, polls both services, and tears containers down through an exit trap. .mcp.json.example configures stdio MCP operation and also includes an optional Bright Data server. .claude/settings.json sends pre-tool, post-tool, and subagent-stop events to .claude/hooks/log-agent-actions-v2.sh. The agent definitions in .claude/agents/n8n-mcp-tester.md, .claude/agents/n8n-webhook-tester.md, and .claude/agents/n8n-workflow-builder.md encode functional testing, webhook testing, and incremental implementation roles.

Observed

Interfaces
Claude Code agent definitions, MCP tools, shell helpers, Docker Compose, and the n8n web interface
Packaging
Docker Compose runs published n8n and n8n-MCP container images
Local service
The n8n container exposes port 5678 and persists data in a host-mounted directory
Management access
Workflow management requires an n8n API key; documentation and search tools remain available without one
Implementation languages
Repository material shown consists primarily of Markdown guidance, Bash scripts, JSON configuration, YAML, and exported workflow JSON conventions
Agent structure
Separate definitions cover architecture, incremental workflow building, MCP functional testing, webhook testing, and debugging guidance
Observability
Claude Code hooks log tool activity, with shell helpers for viewing and clearing agent logs
License
No license information appears in the supplied repository text

Read from README.md, AGENTS.md, CLAUDE.md, .mcp.json.example, docker-compose.yml, .claude/settings.json, scripts/start_servers.sh, scripts/view-agent-logs.sh, scripts/clear-agent-logs.sh, scripts/view-agent-logs-v2.sh, .claude/agents/n8n-mcp-tester.md, .claude/hooks/log-agent-actions.sh, .claude/agents/n8n-webhook-tester.md, .claude/hooks/log-agent-actions-v2.sh, .claude/agents/n8n-workflow-builder.md.

What it can do

  • Create n8n workflow from natural language description

    Natural language description of desired automationComplete n8n workflow configuration

  • Modify existing n8n workflows

    Existing workflow ID and modification requirementsUpdated workflow configuration

  • Generate workflow nodes and connections

    Workflow requirements and node specificationsConfigured workflow nodes with proper connections

  • Build API integrations for workflows

    API endpoints and integration requirementsConfigured API nodes and authentication setup

  • Set up workflow triggers and conditions

    Trigger specifications and conditional logic requirementsConfigured trigger nodes and conditional workflow paths

  • Deploy workflows to n8n instance

    Workflow configuration and deployment parametersActive workflow running on n8n server

Tags

mcpn8nclaude-codeautomationworkflows

Tech Stack

Shell

Comments (0)

No comments yet

Editorially curated, with community endorsements as a secondary signal. Corrections welcome.