- Category
- AI Agents
- Rank
- No. 116Tools index
- Type
- APP
- Builder
- czlonkowski
- GitHub
- 22.8k stars
- Latest release
- v2.82.1
- Date
About
n8n-MCP is a Model Context Protocol server that gives AI assistants deep, structured access to n8n's 1,650 workflow-automation nodes — their documentation, properties, and operations — so Claude and other models can build n8n workflows.
What it does
It helps an AI discover suitable n8n nodes and templates, inspect required configuration, validate proposed workflows, and, when an n8n API connection exists, manage and test workflows. It supports local standard input and remote HTTP operation, plus a hosted option.
Why it's ranked here
The case is strong because discovery, examples, validation, and optional deployment live in one MCP surface. The documented corpus spans 2,412 nodes and 2,352 templates. However, operation and documentation coverage remain incomplete, so the assistant still needs verification and cautious deployment practices.
What's good
Search results can include configurations extracted from real templates, while node inspection offers minimal, standard, and full detail levels to control context size. Validation covers required fields, complete node configuration, workflow connections, and expressions. The server also separates documentation access from API-backed workflow management.
Tradeoffs
The README reports only 66.5 percent operation coverage and 86 percent documentation coverage. Example availability varies with node popularity. Management features require n8n API configuration, and external testing works only for webhook, form, and chat triggers because the public API cannot directly execute arbitrary workflows.
How to use it well
Use it with an MCP-capable coding assistant when designing, validating, or cautiously deploying n8n automations. Search templates first, inspect every chosen node, set behavior-controlling parameters explicitly, and validate before deployment. It does not replace development copies, backups, production change control, or broader execution support for workflows without externally callable triggers.
Technical notes+
package.json defines a CommonJS-compatible package export, TypeScript declarations, a command-line binary, build scripts, Vitest unit, integration, and end-to-end commands, plus HTTP and stdio start modes. src/index.ts exposes the engine, HTTP server, documentation server, stdio guard, multi-tenant types, UI metadata, and MCP SDK types for library consumers. src/mcp/index.ts selects HTTP only for the literal http mode, otherwise installs stdout protection for JSON-RPC, runs the stdio server, and handles platform-aware shutdown. src/mcp/server.ts builds the MCP tools and resources server around an SQLite node database, optional n8n management tools, validation services, templates, UI resources, skills, caching, telemetry, additional tools, and protocol negotiation. src/types/index.ts defines tool schemas and MCP behavior annotations. src/triggers/index.ts limits external workflow testing to registered webhook, form, and chat handlers.
Observed
- License
- package.json declares MIT, while the header in src/index.ts states Sustainable Use License v1.0.
- Primary language
- TypeScript, compiled with the TypeScript compiler.
- Packaging and install surface
- Published npm package with a command-line binary; README also documents hosted, npx, Docker, Railway, and local options.
- Interfaces
- MCP over stdio or HTTP, plus an exported library engine and optional n8n API-backed management tools.
- Testing structure
- package.json defines Vitest unit, integration, end-to-end, coverage, stdio, endpoint, Docker, and runtime smoke-test commands.
Read from README.md, package.json, src/index.ts, src/mcp/index.ts, src/mcp/server.ts, src/types/index.ts, src/triggers/index.ts, src/community/index.ts, src/telemetry/index.ts, src/mcp/ui/index.ts, src/mcp/skills/index.ts, src/mcp/tool-docs/index.ts, src/mcp/tool-docs/guides/index.ts, src/mcp/tool-docs/system/index.ts, src/mcp/tool-docs/discovery/index.ts.
What it can do
Provide AI assistants access to n8n node documentation
AI assistant queries about n8n nodes → Structured documentation for 1,650 n8n workflow automation nodes
Search and retrieve n8n node properties and schemas
Node name or property query → Detailed node properties with 99% coverage and schemas
Access n8n node operations and actions
Node operation requests → Available node operations with 63.6% coverage of actions
Search verified community n8n integrations
Community node search query with source filter → Filtered list of 830 verified community nodes
Retrieve workflow template configurations
Template search or workflow requirements → 2,352 workflow templates with AI metadata
Provide real-world n8n workflow examples
Workflow use case or configuration request → 156 ranked workflow configurations from popular templates
Enable AI tool detection and documentation
AI tool capability queries → 265 AI-capable tool variants with full documentation
Tags
Tech Stack
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.