n8n Pro MCP

n8n-pro-mcp connects Claude Code, Claude Desktop, Cursor or any MCP client to your n8n instance via the official n8n public API v1, with automatic cursor pagination, exponential-backoff retry on reads (writes and webhook calls are never retried, so side effects can't duplicate), and offline workflow validation that catches the classic n8n mistakes (malformed {{ }} expressions, webhook data accessed without .body…. Its 23 documented tools cover workflow, execution, workflows, executions.

People connecting automation tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-06-12 · ★ 3 · #138 OF 194 MAINTAINED AUTOMATION · VERIFIED 2026-08-25

MIT · TypeScript servers · how we verify → /methodology

01 · Install n8n Pro MCP

before you install - you'll need

Set N8N_API_URL, N8N_API_KEY before connecting.

Claude Code

claude mcp add helbertparanhos-n8n-pro-mcp -- npx -y n8n-pro-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "helbertparanhos-n8n-pro-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "n8n-pro-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package n8n-pro-mcp - unscoped; check the name against the project README before installing

registry namespace io.github.helbertparanhos is GitHub-verified and matches the repo owner

03 · What n8n Pro MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can list with filters (active, tags, project, name) + auto pagination, create from JSON, with automatic offline validation, move between projects, and filter by status/workflow/project, with durations.

Capability map

Tools grouped from the project's README - what n8n Pro MCP lets an agent do.

Workflow

7 tools - e.g. Full JSON or lightweight summary of one workflow; Create from JSON, with automatic offline validation; Partial update - fetch, merge, validate, PUT

get_workflow · create_workflow · update_workflow · delete_workflow · transfer_workflow · clone_workflow…

Execution

6 tools - e.g. Summary or full node-level run data for debugging; Remove an execution record; Retry a failed/stopped execution

get_execution · delete_execution · retry_execution · wait_for_execution · summarize_execution_error · get_execution_stats

Workflows

3 tools - e.g. List with filters (active, tags, project, name) + auto pagination; Free-text search across names, node names and node types; Bulk activate/deactivate by tag, with dry run

list_workflows · search_workflows · set_workflows_active_by_tag

read & search

2 tools - e.g. Filter by status/workflow/project, with durations; Queue-mode live view of running/queued executions

list_executions · list_running_executions

run & execute

1 tool - e.g. Trigger workflows via production or test webhook

run_webhook

Prune

1 tool - e.g. Bulk-delete old execution records, dry run by default

prune_executions

Check

1 tool - e.g. healthz + readiness (DB) + API auth, with a plain-language summary

check_health

Generate

1 tool - e.g. n8n's built-in security audit (credentials, database, nodes, filesystem, instance)

generate_audit

Latest releases

v1.0.0 · 2026-06-12

Full-instance management for self-hosted n8n - including queue mode - via the Model Context Protocol. · 51 tools in 8 categories: workflows (CRUD + safe partial update + clone + bulk-by-tag + offline validation)…

04 · Who maintains n8n Pro MCP

n8n Pro MCP is maintained by helbertparanhos. We track 6 MCP servers from helbertparanhos - 6 actively maintained, 7 combined GitHub stars, oldest repo from Jun 2026. Full record: all servers from helbertparanhos.

  1. Cloudflare MCP Pro Cloudflare MCP: DNS, Zones, Workers, KV, R2, D1, Pages, WAF, SSL, Email, AI via REST API v4 ★ 2

05 · Facts

category
automation - ranked #138 of 194 actively-maintained automation servers as of 2026-08-25.
release cadence
1 release in the last 90 days (latest 2026-06-12)
registry
io.github.helbertparanhos/n8n-pro-mcp (active, first published 2026-06-12)
packages
npm:n8n-pro-mcp

06 · n8n Pro MCP FAQ

Is n8n Pro MCP still maintained?

Yes - as of 2026-08-25, its last commit was 2026-06-12 and it shipped 1 release in the last 90 days. We re-verify nightly.

What can n8n Pro MCP do?

With this server connected, an agent can list with filters (active, tags, project, name) + auto pagination, create from JSON, with automatic offline validation, move between projects, and filter by status/workflow/project, with durations.

How do I install n8n Pro MCP?

Run `npx -y n8n-pro-mcp`. The README documents 2 environment variables (N8N_API_URL, N8N_API_KEY) to set first. Set N8N_API_URL, N8N_API_KEY before connecting. You can also paste the ready-made client config above.

Does n8n Pro MCP run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to n8n Pro MCP