io.github.ratamaha-git/n8n-mcp

NPM · @AUTOMATELAB/N8N-MCP · SCANNED AUG 4

MCP server for n8n: generate, lint, explain failed executions, drive live n8n via REST.

Available components

+24 this week 64 64 Trust /100

Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security83

No malware found by supply-chain analysis.Pass
CVE check failed: a known medium-severity CVE affects hono 4.12.33, reached via @modelcontextprotocol/sdk > hono. A fixed version is available. View diagnostics → Fail
No install/post-install scripts declared.Pass
Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree. View diagnostics → Partial

Provenance & Transparency19

Repository check failed: the declared repository URL redirects; it must resolve directly. See how to fix → View diagnostics → Fail
Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
Clear OSI-approved license (MIT).Pass
Actively maintained (last published 56 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability79

AI-judged instruction clarity (excellent).Pass
Context-footprint check failed: tool/resource definitions use about 1086 tokens (~120/item across 9 items; 9 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management27

Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage100

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
100% of tool parameters carry a description.Pass

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · @automatelab/n8n-mcp

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add ratamaha-git-n8n-mcp -- npx -y @automatelab/n8n-mcp

# add to Codex CLI

codex mcp add ratamaha-git-n8n-mcp -- npx -y @automatelab/n8n-mcp

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ratamaha-git-n8n-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@automatelab/n8n-mcp"
      ],
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add ratamaha-git-n8n-mcp --command npx --arg -y --arg @automatelab/n8n-mcp

# ~/.hermes/config.yaml

mcp_servers:
  ratamaha-git-n8n-mcp:
    command: "npx"
    args: ["-y", "@automatelab/n8n-mcp"]

// mcp.json

{
  "mcpServers": {
    "ratamaha-git-n8n-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@automatelab/n8n-mcp"
      ]
    }
  }
}

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

4 Aug 26 +3
- CVE-2026-69207 affects this package: medium ▼ security
- Known CVEs: partial → fail ▼ security
- Stability: unverified → 0.27 ▲ functional
2 Aug 26 +26
- Provenance: unverified → fail ▼ security
- Known CVEs: unverified → partial ▲ security
- Install scripts: unverified → pass ▲ security
- Schema quality: unverified → excellent ▲ functional
- License: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Maintenance: unverified → pass ▲ functional
- Licence: MIT functional
1 Aug 26 +20
- Malware scan: unverified → pass ▲ security
- Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
- MCP protocol: unverified → pass ▲ functional
31 Jul 26 −25
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
27 Jul 26 40

First indexed and scored.

Show 2 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 4 Aug 2026 · Analysed npm/@automatelab/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Vulnerabilities 1 finding

ID	CVE	Severity	Vector	Fix available
GHSA-8j4g-w8fx-2239	CVE-2026-69207	medium	CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:N/I:N/A:L	yes

Dependencies 95 packages

95 packages in the resolved dependency tree · 95 deprecated · 29 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 9 exposed · ~1,086 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

n8n_activate_workflow ~73

Activate or deactivate a workflow on a live n8n instance (requires N8N_API_URL + N8N_API_KEY). Pass `active: false` to deactivate.

Input Output Examples

Name	Type	Req	Description
active	boolean	—	Defaults to true (activate). Set false to deactivate.
id	string	yes	Workflow ID.

No output schema declared.

No examples provided.

n8n_create_workflow ~115

Create a workflow on a live n8n instance (requires N8N_API_URL + N8N_API_KEY). Strips read-only fields (id, active, createdAt, ...) before posting. Workflows are created inactive — call n8n_activate_workflow afterward. Pairs with n8n_generate_workflow for end-to-end 'describe -> deploy'.

Input Output Examples

Name	Type	Req	Description
workflow	—	yes	Workflow JSON to create (typically the output of n8n_generate_workflow). Either a parsed object or a JSON string.

No output schema declared.

No examples provided.

n8n_explain_execution ~164

Diagnose a failed or surprising n8n execution. Paste the execution JSON (from the n8n UI 'Show details' or `GET /executions/:id?includeData=true`); returns a per-node summary highlighting nodes that returned 0 items, unresolved `={{ ... }}` expressions, errors with hints, and LLM token usage. Hits the most common debugging pain point: items 'silently disappearing' between nodes.

Input Output Examples

Name	Type	Req	Description
execution	—	yes	n8n execution object as either a parsed object or a JSON string. Accepts both the REST API shape (`{ data: { resultData: { runData, error, lastNodeExecuted } }, finished, status, ... }`) and the raw…

No output schema declared.

No examples provided.

n8n_generate_workflow ~149

Generate a valid n8n workflow JSON from a plain-English description. Handles webhook/schedule/RSS triggers, common action nodes (Slack, Google Sheets, Discord, Gmail, Notion, HTTP), and AI Agent setups (LangChain root agent + chat model + memory + optional HTTP tool, wired with ai_languageModel / ai_memory / ai_tool connections). Returns workflow JSON with unique node IDs, connections, positions, and typeVersion on every node.

Input Output Examples

Name	Type	Req	Description
description	string	yes	Plain-English workflow description, e.g. 'Stripe webhook -> Slack message + Google Sheets row'.
name	string	—	Optional workflow name. Derived from the first sentence of the description if omitted.

No output schema declared.

No examples provided.

n8n_get_workflow ~72

Fetch a single workflow JSON by id from a live n8n instance (requires N8N_API_URL + N8N_API_KEY). Returns the full nodes/connections payload — pair with n8n_lint_workflow to audit a deployed workflow.

Input Output Examples

Name	Type	Req	Description
id	string	yes	Workflow ID.

No output schema declared.

No examples provided.

n8n_lint_workflow ~109

Lint an n8n workflow JSON. Returns concrete errors and warnings: missing credentials, deprecated node types (Function -> Code, spreadsheetFile -> convertToFile/extractFromFile), broken connections, missing or non-numeric typeVersion, duplicate node names or IDs, AI Agent missing ai_languageModel sub-node, Webhook missing webhookId, IF node still on v1 condition schema.

Input Output Examples

Name	Type	Req	Description
workflow	—	yes	n8n workflow as either a parsed object or a JSON string.

No output schema declared.

No examples provided.

n8n_list_executions ~159

List recent executions from a live n8n instance (requires N8N_API_URL + N8N_API_KEY). Filter by workflowId, status (success|error|waiting), limit. Pass `includeData: true` to get the full execution body (large) — pair with n8n_explain_execution to diagnose a specific failure.

Input Output Examples

Name	Type	Req	Description
includeData	boolean	—	Include full execution data (large). Default false — pair with n8n_explain_execution.
limit	number	—	Page size (n8n default: 100, max: 250).
status	string	—	Filter by status: success \| error \| waiting.
workflowId	string	—	Filter by workflow ID.

No output schema declared.

No examples provided.

n8n_list_workflows ~148

List workflows from a live n8n instance (requires N8N_API_URL + N8N_API_KEY env vars). Returns id, name, active, nodeCount, updatedAt, tags. Filter by active, tags, name. Use this when the user asks 'what workflows do I have?' or before n8n_get_workflow.

Input Output Examples

Name	Type	Req	Description
active	boolean	—	Filter by active status. Omit to return both.
limit	number	—	Page size (n8n default: 100, max: 250).
name	string	—	Filter by exact workflow name.
tags	string	—	Comma-separated tag names to filter by.

No output schema declared.

No examples provided.

n8n_scaffold_node ~97

Scaffold a TypeScript skeleton for an n8n custom node from a plain-English description. Returns a single TypeScript file implementing INodeType with description, credentials reference, and an execute method stub.

Input Output Examples

Name	Type	Req	Description
description	string	yes	Plain-English description of what the node should do.
nodeName	string	—	Optional PascalCase node class name, e.g. 'DiscordRateLimited'. Derived from the description if omitted.

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

27 Jul 4 Aug

Day	Score
27 Jul	40
28 Jul	40
30 Jul	40
31 Jul	15
1 Aug	35
2 Aug	61
3 Aug	61
4 Aug	64