n8n-mcp
A MCP for Claude Desktop/Claude Code/Windsurf/Cursor to build n8n workflows
GraphCanon updated today · GitHub synced today
Decision brief
n8n-mcp integrates with AI tools like Claude Desktop, Claude Code, Windsurf, Cursor to manage n8n workflows.
Good fit when
- When aiming for seamless integration between specific AI development tools and n8n.
- If TypeScript development aligns with your project's tech stack.
Avoid when
- Avoid if your project requires support for a wider range of AI tools beyond those specified.
- Not suitable when the project cannot accommodate a dependency on TypeScript.
Observed Jul 17, 2026 · Source: enrich:decision_facts
Verify the decision
Adoption
Package downloads where a registry match exists. GitHub stars (22,782) are secondary evidence.
- npm downloads (30d)
- 642,202·npm downloads API·today
Maintenance and security
Full trust report- Maintenance
- Very active (1d since push)
- As of today
- Provenance
- Not a fork · Personal account
- As of today
- Security (OSV)
- No MCP manifest
- As of 1mo
Public GitHub metadata and optional OSV scans. Signals, not a guarantee. Trust methodology.
Install
npm install n8n-mcpHow it fits your stack(1)
Typed graph edges - alternatives, integrations, successors, and dependencies. Ranked by relationship type, not raw GitHub stars.
Relationship graph
Optional deeper exploration of typed edges and category neighbours.
Similar tools
Same-category neighbours not already linked as typed edges.
Evidence and technical details
Sourced facts, taxonomy, compatibility claims, README excerpt, and machine-readable endpoints.
Overview
This repo offers functionality to create and manage n8n workflows via integration with various AI tools like Claude Desktop, Claude Code, Windsurf, Cursor. Written in TypeScript.
Capability facts
- Deploy
- Self-host
Source: dockerfile:Dockerfile · Aug 25, 2026
- Docker
- Dockerfile present
Source: dockerfile:Dockerfile · Aug 25, 2026
- CLI
- CLI entrypoint
Source: package.json:bin|scripts · Aug 25, 2026
- MCP server
- Ships MCP server
Source: package.json:@modelcontextprotocol/* · Aug 25, 2026
- Languages
- typescript, javascript
Source: github.language+package.json · Aug 25, 2026
Categories
Compatibility
Sourced claims from the README excerpt - not unsourced marketing copy.
Source: README excerpt (regex_v1, Aug 25, 2026)
**Want to self-host?** See the [Self-Hosting Guide](./docs/SELF_HOSTING.md) for npx, Docker, Railway, and local installation options.Source link
Tags
README
Quick Start
The fastest way to try n8n-MCP - no installation, no configuration:
- Free tier: 100 tool calls/day
- Instant access: Start building workflows immediately
- Always up-to-date: Latest n8n nodes and templates
- No infrastructure: We handle everything
Just sign up, get your API key, and connect your MCP client.
Want to self-host? See the Self-Hosting Guide for npx, Docker, Railway, and local installation options.
Level 4 - Post-Deployment
n8n_validate_workflow({id})- Validate deployed workflown8n_autofix_workflow({id})- Auto-fix common errorsn8n_executions({action: 'list'})- Monitor execution status
Read-Only Deployment
For governance-sensitive environments, use both env vars together. Fully disable tools that are write/destructive or handle sensitive data (n8n_manage_credentials and n8n_manage_datatable also offer read operations, but are removed entirely here because even reads expose sensitive material):
DISABLED_TOOLS=n8n_create_workflow,n8n_update_full_workflow,n8n_update_partial_workflow,n8n_delete_workflow,n8n_autofix_workflow,n8n_deploy_template,n8n_test_workflow,n8n_manage_credentials,n8n_manage_datatable
For tools that bundle read and write operations under one name, block only the destructive operations while keeping list and get:
DISABLED_TOOL_OPERATIONS=n8n_workflow_versions:delete,rollback,prune;n8n_executions:delete;n8n_evaluations:run,cancel;n8n_manage_folders:create,rename,move,delete
Combine with a read-only n8n API key (Settings → API in your n8n instance) for defence in depth. See Read-Only Deployment Recipe for the full setup guide.
License
MIT License - see LICENSE for details.
For agents
This page has a .md twin and JSON over the API.