MCP server
n8n MCP Server (n8n-mcp)
- Maintainer
- Community
- Runs
- Local (stdio)
- GitHub
- ★ 23,127, last push 2026-10-24 (checked 2026-10-24)
- License
- MIT
- Connects to
- n8n
Install the n8n MCP Server (n8n-mcp)
Pick your client. Each tab starts the same local command. Config shapes checked against each client's docs on 2026-10-25.
Run in a terminal. Everything after -- is the command that starts the server. docs
claude mcp add --transport stdio n8n -- npx -y n8n-mcp
Claude Desktop only: Settings > Developer > Edit Config opens claude_desktop_config.json. Add this, save and restart the app. docs
{
"mcpServers": {
"n8n": {
"command": "npx",
"args": [
"-y",
"n8n-mcp"
]
}
}
}Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project), or use the install button. docs
{
"mcpServers": {
"n8n": {
"command": "npx",
"args": [
"-y",
"n8n-mcp"
]
}
}
}Add to .vscode/mcp.json (note the "servers" key and the type), or use the install button. Command Palette > "MCP: Open User Configuration" for all workspaces. docs
{
"servers": {
"n8n": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"n8n-mcp"
]
}
}
}Run codex mcp add n8n -- npx -y n8n-mcp, or add this to ~/.codex/config.toml. docs
[mcp_servers.n8n] command = "npx" args = ["-y", "n8n-mcp"]
Run in a terminal (-s user adds it for all projects; the default is this project). docs
gemini mcp add -s user n8n npx -- -y n8n-mcp
Run in a terminal; it writes ~/.copilot/mcp-config.json. docs
copilot mcp add n8n -- npx -y n8n-mcp
Add to mcp_config.json: ~/.config/devin/mcp_config.json on macOS and Linux (older installs: ~/.codeium/windsurf/mcp_config.json), %APPDATA%\devin\ on Windows. docs
{
"mcpServers": {
"n8n": {
"command": "npx",
"args": [
"-y",
"n8n-mcp"
]
}
}
}Add to Zed's settings.json (or Settings > AI > MCP Servers > Add Server). Remote servers without an Authorization header sign in with OAuth. docs
{
"context_servers": {
"n8n": {
"command": "npx",
"args": [
"-y",
"n8n-mcp"
]
}
}
}Add to opencode.json in the project (or ~/.config/opencode/opencode.json). docs
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"n8n": {
"type": "local",
"command": [
"npx",
"-y",
"n8n-mcp"
],
"enabled": true
}
}
}Add to ~/.kiro/settings/mcp.json (all projects) or .kiro/settings/mcp.json (this project). docs
{
"mcpServers": {
"n8n": {
"command": "npx",
"args": [
"-y",
"n8n-mcp"
]
}
}
}MCP Servers > Configure > Configure MCP Servers opens cline_mcp_settings.json; add this entry. docs
{
"mcpServers": {
"n8n": {
"command": "npx",
"args": [
"-y",
"n8n-mcp"
]
}
}
}Tools it exposes
Node documentation and validation work without an n8n instance; the n8n_ tools need your instance's URL and API key.
search_nodes: Full-text search across n8n nodesget_node: Node details, properties and examplesvalidate_workflow: Validate a whole workflowsearch_templates: Search workflow templatesn8n_create_workflow: Create a workflow in your instancen8n_list_workflows: List workflowsn8n_update_partial_workflow: Update a workflow with diff operationsn8n_test_workflow: Run a workflown8n_executions: List, get or delete executions
From the project's own tool list, checked 2026-11-07. Tools change between releases; your client lists the current ones after you connect.
Security notes
- The local server runs with your user's permissions (npx downloads it from npm on first run).
- Content it reads from the app (tasks, pages, comments) can carry prompt-injection instructions. Keep approval prompts on for anything that writes.
- Community code: read it (or at least the tools it registers) before you give it credentials.
Alternatives
- Notionofficial · ★ 4.7k
Search, read and edit pages and databases in your Notion workspace.
- WordPress MCP Adapterofficial · ★ 1.9k
WordPress plugin that turns registered site abilities into MCP tools for self-hosted sites.
- Atlassian (Jira & Confluence)official · ★ 1.1k
Jira issues and Confluence pages in Atlassian Cloud, hosted with OAuth.
- Todoistofficial · ★ 563
Add, find and complete Todoist tasks and projects.
- monday.comofficial · ★ 435
Boards, items, updates and docs in monday.com.
- Contentfulofficial · ★ 60
Manage Contentful entries, assets, content types and spaces through the Management API.
- Apollo.ioofficial · ★ 32
Hosted server to find and enrich prospects and manage Apollo sequences.
- Airtableofficial
Airtable's hosted server to search bases and read, create and update records.
FAQ
What does the n8n MCP Server (n8n-mcp) do?+
Docs for every n8n node and tools to build and validate n8n workflows. Its tools include search_nodes, get_node, validate_workflow, search_templates and n8n_create_workflow.
Is the n8n (n8n-mcp) MCP server official?+
Community-maintained (czlonkowski on GitHub), not by the company whose product it connects to.
How do I add n8n (n8n-mcp) to Claude Code?+
Run: claude mcp add n8n -- npx -y n8n-mcp. Add --scope project to share it with your team through .mcp.json.
How do I use the n8n (n8n-mcp) MCP server in Cursor or VS Code?+
Open the Cursor or VS Code tab above: it has the mcp.json entry and a one-click install link. Cursor uses the "mcpServers" key; VS Code uses "servers" and needs a type ("stdio").
Does n8n (n8n-mcp) work in ChatGPT and claude.ai?+
No: it runs locally over stdio, and ChatGPT and claude.ai only connect to remote servers. Use it in Claude Desktop, Claude Code, Cursor, VS Code or another client that can start a local process.
What are the alternatives to the n8n (n8n-mcp) MCP server?+
Other productivity MCP servers: Notion, WordPress MCP Adapter, Atlassian (Jira & Confluence), Todoist and monday.com.