Vibeleaderboard
Index / tool
Visit github.com
Category
AI Agents
Rank
No. 1680Tools index

Previous survey · No. 1662 ·

Pricing
Open Source
Type
TOOL
GitHub
62 stars
Date

About

MCP server for Claude Desktop to manage your n8n workflows directly from the AI assistant.

What it does

It gives an AI agent a structured set of controls for an n8n instance. Those controls create, inspect, update, list, and delete workflows, inspect or remove execution records, trigger active workflows through webhooks, and check connectivity. Requests travel over standard input and output, while the server calls n8n’s API with a configured URL and API key.

Why it's ranked here

The tool covers the core workflow and execution loop, validates inputs, supports cursor pagination, retries selected transient failures, and works around incompatible workflow update methods. The decisive drawback is lifecycle status: development has stopped, and the author directs users to the broader n8n-mcp project for current features and updates.

What's good

The implementation anticipates awkward n8n API behavior. It supplies required workflow defaults, strips read-only fields before updates, and falls back from PATCH to PUT when needed. Tool descriptions explain operational constraints to the agent, including full-node updates and matching webhook methods. File-only logging keeps protocol output clean, while typed errors distinguish authentication, authorization, rate limits, timeouts, and network failures.

Tradeoffs

Workflow activation still requires the n8n interface, and direct execution works only through an active webhook trigger. The exposed tools cannot manage users or credentials, stop running executions, handle variables, or import and export workflows. Tags cannot be written. Update requests may require fetching and resending the full workflow. The repository is no longer actively developed, so unresolved compatibility issues should not be expected to receive updates here.

How to use it well

Use it for an existing n8n installation when an agent needs routine workflow editing, execution inspection, cleanup, webhook triggering, and connection checks. It fits controlled operator workflows where manual activation is acceptable and API credentials can be supplied through environment variables. Start with the health check, fetch before updating, and preserve the full node graph. Choose the successor project for ongoing development or broader automation. Keep the n8n interface for activation, credentials, users, and stopping executions.

Technical notes+

src/index.ts detects stdio mode, suppresses normal startup output, installs signal handlers, and starts the server. src/server.ts registers MCP list and call handlers, injects a shared API client, performs a nonfatal startup health check, and connects through StdioServerTransport. src/tools/index.ts exposes eleven tools assembled from workflow, execution, health, and discovery modules. src/tools/workflows.ts and src/tools/executions.ts validate arguments with Zod and format text responses. src/services/n8nClient.ts appends the n8n API prefix, authenticates with the API-key header, retries selected failures exponentially, removes read-only workflow fields, and falls back from PATCH to PUT. src/utils/logger.ts writes rotating files and avoids console transport in MCP mode.

Observed

License
MIT
Primary language
TypeScript with ES modules
Runtime
Node.js 20 or higher
Install surface
Clone the repository, install dependencies with npm, then compile with the TypeScript build script
Interfaces
Model Context Protocol over standard input and output, backed by n8n API v1 and webhook HTTP requests
Tool surface
Eleven MCP tools covering workflows, executions, webhooks, health checks, and tool discovery
Lifecycle
The repository is no longer actively developed; its management tools moved into n8n-mcp

Read from README.md, package.json, src/index.ts, src/server.ts, src/tools/info.ts, src/tools/index.ts, src/types/index.ts, src/tools/health.ts, src/utils/errors.ts, src/utils/logger.ts, src/tools/workflows.ts, src/tools/executions.ts, src/config/environment.ts, src/services/n8nClient.ts, src/services/validation.ts.

What it can do

  • List available n8n workflows

    Connection to n8n instanceList of workflow names and IDs

  • Execute n8n workflow

    Workflow ID and optional parametersWorkflow execution results and status

  • Get workflow execution status

    Execution IDCurrent execution state and progress

  • Retrieve workflow details

    Workflow IDWorkflow configuration and node information

  • Monitor workflow execution logs

    Workflow or execution IDExecution logs and error messages

  • Stop running workflow execution

    Execution IDCancellation confirmation and final status

Tags

mcpn8nclaude-desktopautomationworkflows

Tech Stack

Node.jsTypeScript

Comments (0)

No comments yet

Editorially curated, with community endorsements as a secondary signal. Corrections welcome.