
n8n-mcp-cc-buildier
https://github.com/czlonkowski/n8n-mcp-cc-buildier- Category
- AI Agents
- Rank
- No. 1583Tools index
- Pricing
- Open Source
- Type
- TOOL
- Builder
- czlonkowski
- 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 automation → Complete n8n workflow configuration
Modify existing n8n workflows
Existing workflow ID and modification requirements → Updated workflow configuration
Generate workflow nodes and connections
Workflow requirements and node specifications → Configured workflow nodes with proper connections
Build API integrations for workflows
API endpoints and integration requirements → Configured API nodes and authentication setup
Set up workflow triggers and conditions
Trigger specifications and conditional logic requirements → Configured trigger nodes and conditional workflow paths
Deploy workflows to n8n instance
Workflow configuration and deployment parameters → Active workflow running on n8n server
Tags
Tech Stack
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.