n8n-MCP

by Romuald CzłonkowskiConnectorGet organised

Lets your AI agent find the right n8n nodes and build, check and fix workflows for you

About n8n-MCP

An open-source connector that gives an AI agent n8n's node documentation and workflow templates, so it can build and check automations for you. With your n8n address and API key it can also create and update them.

For n8n usersAutomation builders

Made by Romuald Członkowski

An open-source project by Romuald Członkowski, who runs AiAdvisors, an AI consultancy and official n8n Expert Partner.

Stars: ★ 23k
License: MIT
Cost: Free
Level: Intermediate
Runs: Local · Cloud

Screenshots

From the project's own repository · 3 images, swipe or use the arrows.

A workflow list card from n8n-MCP with demo data, showing whether each workflow is active — Image: Romuald Członkowski (MIT). Original file

An n8n-MCP result card with demo data, after saving a workflow from a template with one credential still to set up — Image: Romuald Członkowski (MIT). Original file

Overview

n8n-MCP is an open-source connector that gives an AI agent the documentation for n8n's automation nodes and thousands of workflow templates. You describe the automation you want; the agent looks up the nodes, checks their settings and builds the workflow. Once you add your n8n address and API key, it can also create, test and update workflows in your own n8n. It suits people who build automations in n8n and want an assistant to handle the setup.

It gives the agent n8n's real node settings and checks each workflow before it is saved, so builds start from documented options.

Try these first

Start with the first one: it is a small task you can check easily.

Find a template that sends a Slack message when a form is submitted and describe its nodes. Don't change anything in n8n.First try · read-only
Which n8n nodes can read new rows from a Google Sheet? Show the settings each one needs.
Build a workflow that emails me a summary of new [form] entries every Monday, and check it before saving.writes to n8n
My workflow [name] failed last night. Look at the run and suggest a fix.reads your n8n

Example prompts written by Agent Flows Hub.

Capabilities

From the creator's documentation.

Toolset	What your agent can do	Access
Node lookup	Search n8n's core and community nodes and read their settings and docs	Read
Templates	Search workflow templates by task, node or keyword	Read
Checks	Check node settings and whole workflows for errors before saving	Read
Workflow changes	Create, update, test and delete workflows in your n8n	Your n8n, read + write
Runs	List, read and delete workflow runs to find what failed	Your n8n, read + write
Credentials	List, read, create, change and delete saved credentials in n8n	Your n8n, read + write

Good to know

Describe an automation and let an agent assemble it from real n8n nodes and templates. Without an n8n connection it researches and checks workflows; with your n8n API key it can also create, test and fix them in your instance.

Limits

The author warns against letting AI edit production workflows directly. Copy the workflow, try changes in a test setup and export backups first.
Telemetry is on by default and includes sanitized workflow structures. The project's privacy policy explains what is collected and how to opt out.

Notes by Agent Flows Hub (original project name: n8n-MCP), written from the creator's documentation, not from running it ourselves. n8n-MCP: overview, tools and safety warning · n8n-MCP documentation

Stuck setting it up?

Tell us what happened. We take a look first; if it needs paid work, you get an estimate before anything starts.

Get help

How to start

Open your AI agentClaude Code, Codex, Cursor or another agent that supports MCP.
Paste the install requestIt asks your agent to read the official instructions, tell you what it will connect to and wait for your OK.
Give it a first taskWithout connecting your n8n, ask it to find a template that sends a Slack message when a form is submitted and to describe its nodes.

Steps follow the creator's instructions. The request tells your agent to read them first and wait for your OK.

Before you start

An AI agent that supports MCP, such as Claude Code, Codex or Cursor.
Node.js, or a free n8n-mcp.com account for the hosted version
An n8n instance and its API key, if you want it to create or change workflows
It connects to the internet. Your agent will show you what before installing.
Free. Nothing to pay.

Details

Made by: Romuald Członkowski
License: MIT Terms
Works with: Claude Code, Codex, CursorAs stated by the creator
Runs on: Your computer, Cloud

View source Official docs Report a problem

For AI agents

This page as a Markdown install brief:

/en/library/n8n-mcp/install.md

Other connectors

notebooklm-py Lets your AI agent use Gemini Notebook to make podcasts, quizzes and slides from sources
Notion MCP Lets your AI agent search, read and edit pages in your Notion workspace
Open Computer Use Lets your AI agent see and operate the apps on your computer by clicking and typing
Pascal Editor Lets your AI agent draw rooms, walls and furniture in a 3D home model you can then edit
PayPal MCP Lets your AI assistant create and send PayPal invoices, look up orders and review disputes
Pipeboard Meta Ads MCP Lets your AI assistant check, create and adjust your Facebook and Instagram ad campaigns

See all 52 connectors · An MCP server is missing or disconnected

GitHub