n8n-MCP
An MCP server with n8n node and template knowledge: the agent picks nodes, validates configs and, with API access, creates workflows in your n8n
Install
claude mcp add n8n-mcp \
-e MCP_MODE=stdio \
-e LOG_LEVEL=error \
-e DISABLE_CONSOLE_OUTPUT=true \
-- npx n8n-mcpReference and validation only. For workflow management add -e N8N_API_URL=... and -e N8N_API_KEY=....
This is third-party code. Review the repository files before installing.
What it does
The server gives the agent a bundled database of n8n nodes: properties, operations, docs, example configs and a template library. The agent searches templates and nodes, fetches the parameters it needs and validates individual nodes and whole workflows before running them. If you provide your n8n URL and API key, management tools appear: create, partially update, validate, autofix and test-run workflows. Without a key only reference and validation tools are available.
Who it is for. For people building n8n automations who want an agent to create workflows without node parameter mistakes.
Good fit when
- You need an n8n workflow built from a text description
- The agent gets node parameters wrong and workflows fail at runtime
- You want to find a ready template for a task
Not a fit when
- Your automations are not built in n8n
- You would edit production workflows without a copy or test environment
Example request
Build an n8n workflow that sends a Telegram message on each new webhook submission, validate the config firstLimitations
The author explicitly warns against letting the agent edit production workflows without backups and testing. Workflow management needs N8N_API_URL and N8N_API_KEY. The hosted version at dashboard.n8n-mcp.com has a call limit on the free tier; self-hosting needs Node.js or Docker. Running several clients via npx can hit npm cache locks.
How to disable. Run claude mcp remove n8n-mcp or delete the n8n-mcp entry from the client's MCP config. Revoke the API key in n8n settings.
MCP
- Transport
- stdio, http
- Authentication
- API key
| Environment variables | |
|---|---|
| MCP_MODE required | stdio mode, required for Claude Desktop |
| N8N_API_URL | Your n8n instance URL for management tools |
| N8N_API_KEY secret | n8n API key for creating and editing workflows |
| N8N_MCP_ACCESS_TOKEN secret | n8n instance-level MCP token for agent management tools |
| WEBHOOK_SECURITY_MODE | moderate allows calls to n8n on localhost |
Security check
- With an API key it creates, edits and runs workflows in your n8n
- Holds an n8n access key
README in short
The README describes the n8n node and template knowledge base and warns to be careful with production workflows. The fastest route is the hosted version with a key; self-hosting via npx, Docker, Railway or source is in a separate doc. It includes guides for Claude Code, VS Code, Cursor, Windsurf and Codex, system instructions for Claude projects and a link to the related n8n-skills. MIT licensed.
FAQ
Do I need my own n8n?
Not for reference and validation. For the agent to create and run workflows you need API access to your n8n instance.
Why MCP_MODE=stdio?
Without it debug output goes to stdout and Claude Desktop shows JSON parse errors.
Related
Zapier's official MCP plugin: the agent gets actions across thousands of apps through your Zapier account
Awesome Claude Skills by Composio
Awesome Claude Skills
A curated list of Claude skills and plugins, plus Composio's own automation skills for 78 SaaS apps
A plugin and CLI catalog for agents: generates command-line interfaces for GUI apps like GIMP and Blender and installs ready ones via CLI-Hub
SDKs, a CLI and MCP access to over a thousand prebuilt SaaS integrations for agents, with auth and per-user sessions