n8n-ops-mcp

Active

Ops-focused n8n MCP tools - list, trigger, validate, and audit workflows.

WHAT IT DOES

n8n-ops-mcp is an ops-focused Model Context Protocol server for n8n. It lets an AI client answer "what's broken in my n8n?", trigger workflows from chat, audit for security risks, and safely edit workflows without you leaving the client. It targets the ops surface (list, trigger, validate, edit) rather than indexing n8n's node catalog.

It was built for OpenClaw as a first-class plugin and exposed as an MCP server for everyone else, so it works with Claude Desktop, Claude Code, Codex CLI, Cursor, Windsurf, or any other MCP host with no hard dependency on a specific model or harness.

Writes are off by default. Destructive operations are confirm-gated, workflow deletes snapshot to a backup directory first, and credential writes sit behind a second independent gate. Credential secrets are stripped from every response, including error paths.

INSTALL

Published to npm as n8n-ops-mcp. Install the global binary, or run it on demand with npx. Requires Node.js 20+.

$ npm install -g n8n-ops-mcp

$ npx n8n-ops-mcp # run on demand

CAPABILITIES / TOOLS EXPOSED

Reads & scanners · always available

n8n_list_workflows

List workflows; filter by active / tags / name.

n8n_get_workflow

Fetch one workflow, optionally with the full node graph.

n8n_list_executions

List recent executions; filter by workflow / status.

n8n_get_execution

Fetch an execution with per-node run log + raw error.

n8n_search_executions

Text-search recent executions for an error fragment.

n8n_list_webhooks

Enumerate webhook + form-trigger URLs.

n8n_validate_workflow

Static checks: deprecated nodes, legacy Code API, orphans.

n8n_diff_workflow

Semantic diff a workflow against a snapshot file or object.

n8n_list_schedules

List schedule triggers with human-readable descriptions.

n8n_execution_stats

Per-workflow counts, failure rate, avg + p95 runtime.

n8n_run_audit

Run n8n's built-in security audit (admin/owner key).

n8n_find_workflows_using_node_type

Find every workflow using a given node type.

n8n_find_workflows_using_credential

Credential rotation / blast-radius scanner.

n8n_check_disabled_nodes

Surface disabled nodes the n8n UI does not list.

n8n_list_tags / n8n_get_workflow_tags

Read tags and a workflow’s tag set.

n8n_list_credentials / n8n_get_credential_schema

Credential metadata + type schema (secrets never echoed).

n8n_audit_browser_bridge_usage

Find workflows that call the browser-bridge CLI.

n8n_scaffold_browser_bridge_node

Generate a ready-to-paste browser-bridge node (local).

Writes · hidden unless N8N_ENABLE_EDIT=true

n8n_trigger

Run a workflow via webhook or workflow-id (confirm-gated).

n8n_create_workflow

Create a workflow; dry-run preview without confirm.

n8n_save_workflow

Overwrite a workflow with auto-backup + validation.

n8n_activate / n8n_deactivate

Arm or halt a workflow’s triggers (confirm-gated).

n8n_archive_workflow / n8n_unarchive_workflow

Reversible soft-delete and restore.

n8n_delete_workflow

Permanent delete with snapshot-before-delete.

n8n_cancel_execution / n8n_retry_execution

Stop or retry an execution by id.

n8n_delete_execution / n8n_delete_executions

Delete one or up to 50 execution records.

n8n_retry_executions

Batch retry executions (max 50, abort on 5xx).

n8n_pin_node_data / n8n_unpin_node_data

Pin or clear sample data on a node for testing.

n8n_create_tag / n8n_delete_tag / n8n_set_workflow_tags

Tag CRUD and workflow tag-set replace.

Credential writes · double-gated

n8n_create_credential

Create a credential; secrets redacted from every response.

n8n_delete_credential

Delete a credential (cascades to every referencing workflow).

Write tools require N8N_ENABLE_EDIT=true; credential writes require N8N_ENABLE_CREDENTIALS_WRITE=true on top of that. Full per-tool reference in the README.

CLIENT CONFIG

Stdio transport. Generate an API key in n8n under Settings → API, then point any MCP host at the n8n-ops-mcp binary. Example mcpServers entry (Claude Desktop / Claude Code):

{
  "mcpServers": {
    "n8n": {
      "command": "n8n-ops-mcp",
      "env": {
        "N8N_BASE_URL": "http://localhost:5678",
        "N8N_API_KEY": "your-api-key-here"
      }
    }
  }
}

Required: N8N_BASE_URL, N8N_API_KEY. Optional: N8N_ENABLE_EDIT, N8N_ENABLE_CREDENTIALS_WRITE, N8N_BACKUP_DIR, N8N_MAX_EXECUTION_LOG_BYTES, N8N_REQUEST_TIMEOUT_MS. Also installs as a first-class OpenClaw plugin via clawhub:n8n-ops-mcp.