n8n-mcp-server

MCP.Pizza Chef: leonardsellem

Anyone running n8n, the open-source automation tool, can hand their assistant the controls: list the workflows you have built, switch them on or off, start a run, and check whether the last one succeeded or failed. It is handy when you want a status answer without logging in, or want a routine job kicked off mid-conversation. You supply the address of your own n8n installation plus a key generated in its settings, then add a short config block to Claude Desktop or VS Code.

Unmaintained · No commits in 14 months.

Coding

Other

Use This MCP server To

Kick off a saved automation without opening n8n Check whether last night's workflow run succeeded List every workflow I have built and what it does Turn a workflow on or off by asking Read the error from a failed run and explain it

README

n8n MCP Server

A Model Context Protocol (MCP) server that allows AI assistants to interact with n8n workflows through natural language.

Overview

This project provides a Model Context Protocol (MCP) server that empowers AI assistants to seamlessly interact with n8n, a popular workflow automation tool. It acts as a bridge, enabling AI assistants to programmatically manage and control n8n workflows and executions using natural language commands.

Installation

Prerequisites

Node.js 20 or later
n8n instance with API access enabled

Install from npm

npm install -g @leonardsellem/n8n-mcp-server

Install from source

# Clone the repository
git clone https://github.com/leonardsellem/n8n-mcp-server.git
cd n8n-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

# Optional: Install globally
npm install -g .

n8n-mcp-server FAQ

Do I need my own n8n?

Yes — this controls an n8n installation you already run, whether that sits on your own machine or on a host.

Which apps does it work in?

Claude Desktop and VS Code are the documented setups, and any assistant that accepts a local MCP connection will work.

Do I need a key?

Yes — create one inside n8n's settings under the keys section, then paste it into the configuration alongside your n8n address.

Can I use this to trigger a workflow mid-conversation?

Yes — name the workflow and it starts the run, then reports back on how it went.

How hard is setup?

It is a developer task: install with Node or Docker, build it if you cloned the source, then add a config block with your address and key.

Can it tell me why a run failed?

Yes — it can list past runs and their results, so you can ask what went wrong without opening the dashboard.