# MCP n8n Server (community) > A community MCP server that lets your agent build, validate, debug and manage workflows on your own n8n instance. A community MCP server by Leo (leonardosepulvedat on GitHub) for running and building n8n workflows from your agent. It isn't made by n8n. It talks to your own n8n instance through n8n's public API and adds a builder loop on top: a catalog of n8n's nodes with their real parameter schemas, validation before you save, automatic repair, local snapshots with rollback, and per-node debugging. What you can do with it - List, read, create, update, activate and deactivate workflows, or make surgical edits to single nodes and connections - Search the node catalog and check a workflow against the real node schemas before saving it - Fix common mistakes automatically: missing typeVersion or positions, duplicate names, dangling connections and expression prefixes - Find failed executions, see the failing node and the data that flowed through any node, and retry runs - Get a health report per workflow: success rate, failures and average duration - Search and import official n8n.io templates, or start from its bundled templates - Trigger a webhook workflow to test it end to end - Back up every workflow to JSON files and import them again - With the admin toolset: manage credentials, tags, variables, users, projects and security audits How it connects It runs on your machine with npx -y mcp-n8n and needs two environment variables: N8N_BASE_URL, your instance's address, and N8N_API_KEY, which you create under Settings > n8n API. N8N_TOOLSETS (core, builder and admin; all by default) limits which tools it exposes. It can also run as a remote HTTP server behind a bearer token, or in Docker. Good to know - n8n's API is available on every self-hosted plan; on n8n Cloud it needs a paid plan. - The API key gives full access to your n8n instance, and some tools need an owner or admin role. - Before every update, partial edit, autofix or delete it saves a local snapshot (in ~/.mcp-n8n/snapshots), so you can diff and roll back, and even recreate a deleted workflow. - There's no read-only mode. Set N8N_TOOLSETS=core,builder to leave out the admin tools. - Type: Plugin - Made by: leonardosepulvedat - Category: Automation - Formats: Local MCP - Version: 1.5.0 - Website: https://github.com/leonardosepulvedat/mcp-n8n - Source: https://github.com/leonardosepulvedat/mcp-n8n - Page: https://pluginboard.ai/plugins/mcp-n8n ## Works with - Claude - GitHub Copilot - Cursor - Claude Code - Codex - Antigravity - Gemini CLI - OpenClaw - OpenCode - Hermes Agent ## Install You'll need: - `N8N_BASE_URL` (required): Base URL of the n8n instance (e.g. https://your-n8n-instance.com) - `N8N_API_KEY` (required): n8n API key (Settings -> n8n API) - `N8N_TOOLSETS` (optional): Comma-separated toolsets to expose: core, builder, admin (default: all) Replace each `` placeholder with your own value. ### Claude Add to claude_desktop_config.json: ```json { "mcpServers": { "mcp-n8n-server-community": { "command": "npx", "args": [ "-y", "mcp-n8n@1.5.0" ], "env": { "N8N_BASE_URL": "", "N8N_API_KEY": "" } } } } ``` ### GitHub Copilot Add to VS Code: vscode:mcp/install?%7B%22name%22%3A%22mcp-n8n-server-community%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22mcp-n8n%401.5.0%22%5D%2C%22env%22%3A%7B%22N8N_BASE_URL%22%3A%22%3CN8N_BASE_URL%3E%22%2C%22N8N_API_KEY%22%3A%22%3CN8N_API_KEY%3E%22%7D%7D Run in your terminal: ```shell code --add-mcp '{"name":"mcp-n8n-server-community","command":"npx","args":["-y","mcp-n8n@1.5.0"],"env":{"N8N_BASE_URL":"","N8N_API_KEY":""}}' ``` Copilot CLI: ```shell copilot mcp add mcp-n8n-server-community --env N8N_BASE_URL= --env N8N_API_KEY= -- npx -y mcp-n8n@1.5.0 ``` ### Cursor Add to Cursor: cursor://anysphere.cursor-deeplink/mcp/install?name=mcp-n8n-server-community&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIm1jcC1uOG5AMS41LjAiXSwiZW52Ijp7Ik44Tl9CQVNFX1VSTCI6IjxOOE5fQkFTRV9VUkw%2BIiwiTjhOX0FQSV9LRVkiOiI8TjhOX0FQSV9LRVk%2BIn19 Add to .cursor/mcp.json: ```json { "mcpServers": { "mcp-n8n-server-community": { "command": "npx", "args": [ "-y", "mcp-n8n@1.5.0" ], "env": { "N8N_BASE_URL": "", "N8N_API_KEY": "" } } } } ``` ### Claude Code Run in your terminal: ```shell claude mcp add -e N8N_BASE_URL= -e N8N_API_KEY= mcp-n8n-server-community -- npx -y mcp-n8n@1.5.0 ``` ### Codex Run in your terminal: ```shell codex mcp add --env N8N_BASE_URL= --env N8N_API_KEY= mcp-n8n-server-community -- npx -y mcp-n8n@1.5.0 ``` ### Antigravity Add to ~/.gemini/config/mcp_config.json: ```json { "mcpServers": { "mcp-n8n-server-community": { "command": "npx", "args": [ "-y", "mcp-n8n@1.5.0" ], "env": { "N8N_BASE_URL": "", "N8N_API_KEY": "" } } } } ``` ### Gemini CLI Run in your terminal: ```shell gemini mcp add -e N8N_BASE_URL= -e N8N_API_KEY= mcp-n8n-server-community npx -y mcp-n8n@1.5.0 ``` ### OpenClaw In a terminal: Run openclaw mcp add mcp-n8n-server-community --command npx, with --arg before each argument (-y mcp-n8n@1.5.0) and --env NAME=value for each variable it needs. ### OpenCode Run in your terminal: ```shell opencode mcp add mcp-n8n-server-community --env N8N_BASE_URL= --env N8N_API_KEY= -- npx -y mcp-n8n@1.5.0 ``` ### Hermes Agent Add to ~/.hermes/config.yaml: ```json { "mcp_servers": { "mcp-n8n-server-community": { "command": "npx", "args": [ "-y", "mcp-n8n@1.5.0" ], "env": { "N8N_BASE_URL": "", "N8N_API_KEY": "" } } } } ``` --- From Pluginboard (https://pluginboard.ai).