v1.1.1

n8n MCP maintenance update

Correct runtime version reporting and document all twelve current MCP tools.

Installation, compatibility, reproducible inputs and result limits are documented in the maintenance guide. Snapshot products retain source and review dates separately from publication.

v0.5.0 - 3 new tools, 10 lint rules, runtime policy, hosting templates

What's new

3 new tools

• workflow.diff - Semantic diff between two workflows. Reports nodes added/removed/modified (with field-level deltas: type, typeVersion, parameters, credentials, disabled, position), connection topology changes, and settings drift. Ignores noise (small position deltas, createdAt/updatedAt). Pair with workflow.get to compare deployed vs local.
• execution.replay - Build a self-contained replay workflow that exercises a single node from a larger workflow. The replay workflow is Manual Trigger -> Replay Seed (Code) -> target node. Optional inputItems or an execution payload pins what the target sees. Useful for iterating on one stubborn node without re-running the whole pipeline.
• execution.timeline - Render an n8n execution as a per-node timeline: start offset, duration, items in/out, error flag. Complements execution.explain.

10 new lint rules

workflow.lint now catches:

• Rate-sensitive node without retryOnFail/continueOnFail
• Credential drift (credential name doesn't match node type)
• Expression staleness ($('NodeName') referencing missing nodes)
• Code node sandbox violations (require/process/fetch/eval)
• Webhook test path in an active workflow
• manualTrigger wired in an active workflow
• Schedule trigger using triggerAtHour without settings.timezone (DST risk)
• Disabled-but-wired node
• Empty Set node
• HTTP method/body mismatch (GET with body, POST without body)

Runtime policy

Constrain the server without forking. Set these env vars:

• N8N_MCP_READ_ONLY=1 - Disables workflow.create, workflow.activate, node.scaffold.
• N8N_MCP_DISABLED_TOOLS=workflow.create,workflow.activate - Skip specific tools entirely.
• N8N_MCP_ALLOWED_WORKFLOW_IDS=abc,def - REST tools refuse to touch workflows outside the list.
• N8N_MCP_ALLOWED_TAGS=prod,staging - workflow.list filters to workflows carrying at least one tag.

Distribution

• DXT - dxt/manifest.json for Claude Desktop one-click install.
• Docker - Dockerfile + .dockerignore.
• Render / Railway / Fly - render.yaml, railway.toml, fly.toml.

Upgrade

npm install -g @automatelab/n8n-mcp@0.5.0

No breaking changes. All v0.4 tools work identically; the new ones are additive.

v1.0.0 — n8n MCP GitHub Action

n8n MCP GitHub Action

Run n8n MCP tools directly in your CI/CD pipelines.

What it does

• Lint — detect errors and anti-patterns in workflow JSON on every PR
• Explain — post human-readable diagnoses of failed executions as PR comments
• Generate — produce workflow JSON from a plain-English description
• Scaffold — generate a custom node stub from a description

Quick start

```yaml

• uses: ratamaha-git/n8n-mcp@v1.0.0
  with:
  command: lint
  workflow-json: ${{ steps.export.outputs.workflow }}
  ```

See ACTION.md for full input/output reference and GITHUB-ACTION-SETUP.md for Marketplace publication steps.

v0.3.0 - explain_execution, REST tools, references split

What's new in v0.3.0

New tools

• n8n_explain_execution - paste execution JSON, get per-node findings: zero-item nodes, unresolved expressions, error messages with hints. The core debugging tool.
• n8n_list_workflows - list workflows from a live n8n instance (requires N8N_API_URL + N8N_API_KEY)
• n8n_get_workflow - fetch a specific workflow by ID
• n8n_create_workflow - create a workflow on a live instance
• n8n_activate_workflow - activate/deactivate a workflow
• n8n_get_executions - pull recent executions for a workflow

Improvements

• references/ split: skill context broken into focused sub-files so it doesn't bloat the agent prompt
• Gemini CLI extension wrapper added (gemini-extension.json, GEMINI.md)
• README sharpened for awesome-list quotability
• MCP Registry server.json description trimmed to 100-char limit
• Compatibility host list expanded to 10 popular MCP hosts

Previous releases

v0.2.1

• MCP Registry compliance: added mcpName field, server.json

v0.2.0

• AI agent template with correct LangChain cluster topology
• Lint rules: agent missing language model, IF v1 schema, spreadsheetFile deprecation, webhookId

v0.1.1

• Fixed bin path (dropped leading ./)

v0.1.0

• Initial release: n8n_generate_workflow, n8n_lint_workflow, n8n_get_node_info

Community

• SECURITY.md - vulnerability reporting policy
• CONTRIBUTING.md - dev setup and PR process

Built by AutomateLab