← Back to directory
N

n8n-MCP

Community
Help AI assistants understand and build n8n workflows.
GitHub source repository ↗
★ 22.4k Stars Category · Dev Tools Very popular
58FMRS · C
Reliability
8/20
Security and permissions
12/20
Maintenance
13/20
Documentation
14/20
Setup experience
11/20

The source identifies czlonkowski/n8n as the repository and maintainer, with an MIT license and the repository root as the server path. The server manifest is not cached, and the README does not specify a transport protocol or complete client installation configuration.

Read the FMRS scoring method →

n8n-MCP is a Model Context Protocol server that gives AI assistants access to n8n node documentation, properties, operations, templates, and workflow validation. It supports searching and configuring core and community nodes, and can manage workflows, executions, credentials, and data tables when the n8n API is configured.

Tools

tools_documentation
Get documentation for MCP tools.
search_nodes
Search n8n nodes with optional configuration examples.
get_node
Get node information, documentation, properties, versions, or migration details.
validate_node
Validate a node configuration.
validate_workflow
Validate a complete n8n workflow.
search_templates
Search n8n workflow templates.
get_template
Retrieve template workflow content.
n8n_create_workflow
Create an n8n workflow.
n8n_get_workflow
Retrieve an n8n workflow.
n8n_update_full_workflow
Replace an n8n workflow completely.
n8n_update_partial_workflow
Update an n8n workflow using diff operations.
n8n_delete_workflow
Permanently delete an n8n workflow.
n8n_list_workflows
List and filter n8n workflows.
n8n_validate_workflow
Validate a workflow in n8n by ID.
n8n_autofix_workflow
Automatically fix common workflow errors.
n8n_workflow_versions
Manage workflow version history and rollbacks.
n8n_deploy_template
Deploy an n8n.io template to an n8n instance.
n8n_test_workflow
Test or trigger a workflow execution.
n8n_executions
Manage workflow executions.
n8n_evaluations
Read n8n evaluation test runs and metrics.
n8n_manage_datatable
Manage n8n data tables and rows.
n8n_manage_credentials
Manage n8n credentials.
n8n_audit_instance
Perform a security audit of an n8n instance.
n8n_health_check
Check n8n API connectivity and features.

Setup

Register at dashboard.n8n-mcp.com to obtain an API key and connect an MCP client, or follow the repository's self-hosting guide using npx, Docker, Railway, or local installation. To connect an n8n instance, configure N8N_API_URL and N8N_API_KEY. If the instance is behind Cloudflare Access, N8N_CF_CLIENT_ID and N8N_CF_CLIENT_SECRET can also be configured.

Fit and risk

Best for

  • Developers building n8n automation with Claude, Cursor, Windsurf, VS Code, Codex, or Antigravity.
  • n8n users who need node documentation, template discovery, and workflow validation.
  • Teams that want to self-host n8n-MCP or use it through the hosted dashboard.

Not for

  • Automation scenarios that do not use n8n.
  • Users who need n8n instance management without configuring the n8n API.
  • Production workflow changes made without testing.

Required permissions

  • Permissions required for basic node, documentation, template, and validation features are not specified in the source.
  • n8n management features require N8N_API_URL and N8N_API_KEY.
  • Credential and data-table tools may access sensitive n8n data; the source recommends disabling them in governance-sensitive environments.

Risks and side effects

  • AI-generated results may be unpredictable; the source explicitly warns against editing production workflows directly.
  • Copy workflows, test in development, back up important workflows, and validate changes before deployment.
  • Enabling workflow write, delete, credential, or data-table management increases potential impact.

Troubleshooting

  1. Check that N8N_API_URL and N8N_API_KEY are configured correctly.
  2. Use n8n_health_check to check API connectivity and features.
  3. For n8n instances behind Cloudflare Access, check N8N_CF_CLIENT_ID and N8N_CF_CLIENT_SECRET.
  4. Consult the repository's self-hosting, HTTP deployment, and n8n deployment guides.

Use cases

Search n8n nodes, properties, and official documentation.
Design and validate n8n workflows from templates or from scratch.
Create, update, test, and audit workflows after configuring the n8n API.

Supported clients

Claude DesktopFull support
Claude CodeFull support
WindsurfFull support
CursorFull support
Visual Studio CodeFull support
CodexFull support
AntigravityFull support