LibreAI / AI Agents / n8n-mcp
// agents · czlonkowski/n8n-mcp

n8n-mcp

An MCP server that lets Claude, Cursor and Windsurf build n8n workflows for you

★ 23.0k stars⑂ 3.7k forksMITupdated 2026-10
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

n8n-mcp is an open-source ai agents project by czlonkowski (czlonkowski/n8n-mcp on GitHub). It has 23,049 GitHub stars and 3,663 forks, is released under the MIT license, and was last updated on GitHub on 6 October 2026.

GitHub stars
23,049
Forks
3,663
License
MIT
Last updated on GitHub
6 October 2026
Category
AI Agents
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Decide hosted or self-hosted

    Try the hosted dashboard for the fastest start, or self-host the server next to your own n8n instance.

  2. Get n8n-MCP

    Clone the repository, or use the hosted version with an API key from the project dashboard.

  3. Connect your MCP client

    Add the n8n-MCP server to Claude Desktop, Claude Code, Cursor or Windsurf, with your n8n instance details.

  4. Build your first workflow

    Ask your assistant to design a workflow, validate each node, and create it in n8n.

// features

Why people love it

n8n node knowledge

Gives your AI assistant accurate documentation and configuration details for n8n nodes.

Multi-level validation

Validates nodes (minimal and full modes) and whole workflows before they are deployed, catching bad configuration early.

Real workflow templates

Can return real configurations from workflow templates so the assistant starts from working examples.

Live n8n management

Through your n8n instance, the assistant can create and manage workflows, executions and related resources.

Works with major MCP clients

Designed for Claude Desktop, Claude Code, Windsurf and Cursor.

Hosted or self-hosted

Use the hosted dashboard (free tier included) or self-host with npx, Docker or a local install per the README's guide.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Get the source code from GitHub and enter the project directory.

    git clone https://github.com/czlonkowski/n8n-mcp.git
    cd n8n-mcp
  2. Add it to your MCP client

    Point your MCP client at the self-hosted server (the README's self-hosting guide covers npx, Docker and local options).

    {
      "mcpServers": {
        "n8n-mcp": {
          "command": "npx",
          "args": ["-y", "n8n-mcp"]
        }
      }
    }
    # see README self-hosting guide for the exact options
  3. Restart and test

    Restart your MCP client, then ask the assistant to validate a node or draft a small workflow.

    # Restart Claude Desktop / Cursor, then prompt:
    # Build an n8n workflow that posts new RSS items to Slack
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains this project?

It is maintained by Romuald Czlonkowski and contributors on GitHub.

Is it free to use?

Yes - the server is MIT licensed and free. The optional hosted dashboard has a free tier (100 tool calls/day per the README) with paid tiers beyond that.

Does it need a paid API key?

You need access to an n8n instance - its API key - for the assistant to create real workflows, and your AI client's own subscription or API key. n8n itself can be self-hosted for free.

How does it compare to alternatives?

Compared with asking a chatbot to write n8n JSON from memory, n8n-MCP validates nodes and workflows against real n8n schemas and templates, which sharply reduces broken imports.

How do I get started?

Clone the repo or sign up for the hosted dashboard, add the server to your MCP client config, restart the client, and ask it to build a small test workflow.

// keep exploring

Similar tools

AI Agents

MobileBuildMCP

An MCP server and CLI that lets AI agents build, test and run iOS and macOS projects.

★ 6.5k starsMIT
View guide →
AI Agents

jadx-ai-mcp

JADX plugin + MCP server that lets LLMs analyze Android APKs live — decompile, review, find vulnerabilities

★ 2.9k starsApache-2.0
View guide →
AI Agents

godot-ai

Production-grade MCP server for Godot — let AI build scenes, edit scripts and wire your game live

★ 2.9k starsMIT
View guide →
AI Agents

chrome-devtools-mcp

Chrome DevTools for coding agents: an MCP server that lets agents debug and inspect real Chrome

★ 53.1k starsApache-2.0
View guide →
AI Agents

apify-mcp-server

MCP server that lets AI agents run thousands of Apify Store scrapers and crawlers as tools.

★ 10.1k starsMIT
View guide →
AI Agents

zotero-mcp

Connect your Zotero research library to Claude and other AI assistants through MCP.

★ 5.3k starsMIT
View guide →
// alternatives

Alternatives in AI Agents

The most-starred other AI Agents projects in the LibreAI catalogue — the realistic shortlist if n8n-mcp is not the right fit.

Get n8n-mcp

Free and open — grab the source, star the repo, and start creating.