DEV.co
MCP Servers · czlonkowski

n8n-mcp

n8n-MCP is a TypeScript-based Model Context Protocol server that integrates n8n workflow automation with AI assistants (Claude, Cursor, Windsurf). It provides AI models structured access to 2,131 n8n nodes, templates, and documentation to help build and validate workflows programmatically.

Source: GitHub — github.com/czlonkowski/n8n-mcp
22.2k
GitHub stars
3.6k
Forks
TypeScript
Primary language
MIT
License (OSI-approved)

Key facts

Objective fields from the source. Values we can't verify are shown as “Unknown” rather than guessed.

FieldValue
Repositoryczlonkowski/n8n-mcp
Ownerczlonkowski
Primary languageTypeScript
LicenseMIT — OSI-approved
Stars22.2k
Forks3.6k
Open issues46
Latest releasev2.63.1 (2026-07-06)
Last updated2026-07-06
Sourcehttps://github.com/czlonkowski/n8n-mcp

What n8n-mcp is

MIT-licensed MCP server exposing n8n's node registry, properties (99% coverage), operations (63.6% coverage), and 2,352 workflow templates via standardized tools. Supports both cloud deployment (dashboard.n8n-mcp.com) and self-hosting (Docker, Railway, npm). Includes validation, search, and optional n8n instance integration via API.

Quickstart

Get the n8n-mcp source

Clone the repository and explore it locally.

terminalbash
git clone https://github.com/czlonkowski/n8n-mcp.gitcd n8n-mcp# follow the project's README for install & configuration

Need it deployed, integrated, or customized instead? DEV.co ships production installs.

Best use cases

AI-Assisted Workflow Design

Use Claude/Cursor to design n8n workflows from natural language descriptions; MCP provides real-time node documentation and property validation to reduce manual configuration errors.

Template-Driven Development

Leverage 2,352 workflow templates with 99.96% AI metadata coverage to accelerate workflow creation; AI can search by task, complexity, or required services and adapt templates to specific needs.

Integration into Development Workflows

Embed n8n automation design into IDE workflows (VS Code, Cursor, Windsurf) so developers can build integrations without leaving their coding environment.

Implementation considerations

  • Safety-first approach: Always copy workflows before AI editing; validate changes in development before production deployment. README emphasizes this explicitly.
  • Deployment flexibility: Choose between free cloud tier (100 tool calls/day), self-hosted Docker, Railway, or npx; scaling depends on usage and infrastructure.
  • Node coverage varies: Properties have 99% coverage; operations only 63.6%. Some advanced node configurations may require manual review or community feedback.
  • AI client selection matters: Setup differs across Claude Code, VS Code + Copilot, Cursor, and Windsurf. Multiple integration guides provided but require environment-specific configuration.
  • Template quality depends on metadata: 2,352 templates with 99.96% AI metadata coverage, but effectiveness relies on accurate template descriptions and user requirements.

When to avoid it — and what to weigh

  • Production Workflow Edits — README explicitly warns against direct AI editing of production workflows. Use only in development; always copy, test, and validate before deploying to production.
  • Offline or Restricted Network — Cloud tier (dashboard.n8n-mcp.com) requires internet; self-hosting requires Docker, npm, or Railway setup. Not suitable for fully air-gapped environments without infrastructure prep.
  • Non-n8n Automation Platforms — MCP is exclusively designed for n8n workflows. Not applicable for Zapier, Make, or other automation platforms.
  • Low-Code Users Without AI Integration — Benefits primarily accrue when using with Claude Desktop, Claude Code, or supported IDEs. Standalone installation offers limited value without these AI clients.

License & commercial use

MIT License (OSI-approved, permissive). Allows commercial use, modification, and distribution with attribution. No warranty or liability clauses. Suitable for proprietary and open-source projects.

MIT license explicitly permits commercial use. No license restrictions on building, deploying, or monetizing workflows created with n8n-MCP. However, validate compliance with n8n's own licensing (separate from MCP). Recommend review of n8n's commercial terms if deploying enterprise workflows.

DEV.co evaluation signals

Editorial assessment — not user reviews. Directional, with an explicit confidence level.

SignalAssessment
MaintenanceActive
DocumentationStrong
License clarityClear
Deployment complexityLow
DEV.co fitStrong
Assessment confidenceHigh
Security considerations

MCP server exposes n8n node schemas, properties, and operations publicly (cloud tier). No encryption or authentication details provided for self-hosted deployments. Safety warning emphasizes never editing production workflows directly; test in development first. n8n instance integration requires secure credential storage (not detailed). Review self-hosting security guide for network isolation, secret management, and access control.

Alternatives to consider

Direct n8n UI

Native workflow builder without AI assistance; simpler for non-technical users but slower for complex automations; no LLM-driven design.

Zapier with AI (via integrations)

Alternative low-code platform with some AI-assisted features; different node ecosystem and pricing model; less open-source friendly.

Custom n8n node SDK + documentation

Manual integration without MCP; requires custom tooling and documentation; suitable for teams building proprietary nodes or deep n8n customization.

Software development agency

Build on n8n-mcp with DEV.co software developers

Start free at dashboard.n8n-mcp.com (100 tool calls/day) or self-host with Docker. Integrate n8n into your Claude, Cursor, or VS Code workflow in minutes.

Talk to DEV.co

Related open-source tools

Surfaced by semantic similarity across the DEV.co open-source index.

n8n-mcp FAQ

Can I edit production workflows directly with AI?
No. README explicitly warns: make a copy first, test in development, export backups, validate before production. AI results are unpredictable.
What's the cost?
Cloud tier: 100 tool calls/day free, paid tiers beyond. Self-hosting: only cost of infrastructure (Docker, server, or Railway). No license fees for MIT software.
Does it support all n8n nodes?
Mostly: 2,131 nodes documented (826 core + 1,305 community). Properties 99% covered; operations 63.6% covered. Some advanced configurations may need manual review.
Which IDEs are supported?
Claude Code, VS Code (with Copilot), Cursor, Windsurf, Codex, Antigravity. Separate setup guides provided for each. Pick your IDE and follow the guide.

Software developers & web developers for hire

Need help beyond evaluating n8n-mcp? DEV.co is a software development agency offering software development services and web development for teams of every size. Our software developers and web developers build custom software, web applications, APIs, and mcp servers integrations — and maintain them long-term.

Build Smarter Workflows with AI

Start free at dashboard.n8n-mcp.com (100 tool calls/day) or self-host with Docker. Integrate n8n into your Claude, Cursor, or VS Code workflow in minutes.