Is the n8n MCP Server MCP server free to use?

Yes. n8n MCP Server is listed on AllMCPs as a free, open Model Context Protocol server you can install into Claude Desktop, Cursor, or any MCP-compatible client.

Is the n8n MCP Server MCP server free to use?

Yes. n8n MCP Server is listed on AllMCPs as a free, open Model Context Protocol server you can install into Claude Desktop, Cursor, or any MCP-compatible client.

N8n MCP Server

The most complete MCP server for n8n — 43 tools for workflows, data tables, and more.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Install Config Generator

Choose your client

claude_desktop_config.json

{
  "mcpServers": {
    "n8n-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "n8n-mcp-server"
      ]
    }
  }
}

💡 Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

Documentation Overview

mcp-n8n

The most complete MCP server for n8n

43 tools · Workflows · Data Tables · Tags · Credentials · Users · Webhooks · Audit

Quick Start · All 43 Tools · Configuration · Contributing

Why mcp-n8n?

Other n8n MCPs cover workflows and executions. mcp-n8n covers everything — including Data Tables, the only MCP to do so.

Feature	mcp-n8n	leonardsellem	illuminare	czlonkowski
Workflows (CRUD + execute)	10	7	8	4
Executions	3	5	3	2
Data Tables	8	—	—	—
Tags + Workflow Tags	7	—	5	—
Credentials	4	—	3	—
Users	3	—	4	—
Variables	3	—	3	—
Projects (Enterprise)	4	—	4	—
Security Audit	1	—	1	—
Webhooks	1	1	—	1
Health Check	1	—	—	1
Total	43	12	33	20

Data Tables — full CRUD with filters, search, upsert and dry-run. No other MCP has this.

🚀 Quick Start

Claude Code

Terminal

claude mcp add --scope user \
  -e N8N_BASE_URL=http://localhost:5678 \
  -e N8N_API_KEY=your-api-key \
  -- n8n npx -y @nextoolsolutions/mcp-n8n

Cursor

Add to ~/.cursor/mcp.json:

config.json

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": ["-y", "mcp-n8n"],
      "env": {
        "N8N_BASE_URL": "http://localhost:5678",
        "N8N_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json:

config.json

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": ["-y", "mcp-n8n"],
      "env": {
        "N8N_BASE_URL": "http://localhost:5678",
        "N8N_API_KEY": "your-api-key"
      }
    }
  }
}

Config file location:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Windsurf

Add to your Windsurf MCP config:

config.json

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": ["-y", "mcp-n8n"],
      "env": {
        "N8N_BASE_URL": "http://localhost:5678",
        "N8N_API_KEY": "your-api-key"
      }
    }
  }
}

VS Code (Copilot)

Add to your VS Code settings.json:

config.json

{
  "mcp": {
    "servers": {
      "n8n": {
        "command": "npx",
        "args": ["-y", "mcp-n8n"],
        "env": {
          "N8N_BASE_URL": "http://localhost:5678",
          "N8N_API_KEY": "your-api-key"
        }
      }
    }
  }
}

Getting your API key

Open your n8n instance
Go to Settings → n8n API
Create a new API key
Copy it into the N8N_API_KEY environment variable

🛠 Tools

Workflows (10)

Tool	Description
`n8n_list_workflows`	List all workflows with optional filters
`n8n_get_workflow`	Get a workflow by ID (includes nodes, connections, settings)
`n8n_create_workflow`	Create a new workflow from JSON
`n8n_update_workflow`	Update an existing workflow (full replacement)
`n8n_delete_workflow`	Permanently delete a workflow
`n8n_activate_workflow`	Activate a workflow for production
`n8n_deactivate_workflow`	Deactivate a workflow
`n8n_execute_workflow`	Trigger execution with optional input data
`n8n_get_workflow_tags`	List tags associated with a workflow
`n8n_update_workflow_tags`	Replace all tags on a workflow

Executions (3)

Tool	Description
`n8n_list_executions`	List executions with filters (workflow, status, cursor)
`n8n_get_execution`	Get execution status, result data and timing
`n8n_delete_execution`	Delete an execution record

Data Tables (8)

Only available in n8n v1.64+. This is the only MCP server with Data Tables support.

Tool	Description
`n8n_list_datatables`	List all data tables with filtering and sorting
`n8n_create_datatable`	Create a table with typed columns (string, number, boolean, date, json)
`n8n_get_datatable`	Get table metadata (columns, name, ID)
`n8n_get_datatable_rows`	Query rows with filter, full-text search, sorting and pagination
`n8n_insert_datatable_rows`	Insert one or more rows
`n8n_update_datatable_rows`	Update rows matching a filter (supports dry-run)
`n8n_upsert_datatable_row`	Update if exists, insert if not
`n8n_delete_datatable_rows`	Delete rows matching a filter (supports dry-run)

Tags (5)

Tool	Description
`n8n_list_tags`	List all tags
`n8n_get_tag`	Get a tag by ID
`n8n_create_tag`	Create a new tag
`n8n_update_tag`	Rename a tag
`n8n_delete_tag`	Delete a tag

Credentials (4)

Tool	Description
`n8n_list_credentials`	List credentials (names and types only — data is redacted)
`n8n_create_credential`	Create a credential (use `get_credential_schema` first)
`n8n_delete_credential`	Delete a credential
`n8n_get_credential_schema`	Get the JSON schema for a credential type

Users (3)

Tool	Description
`n8n_list_users`	List all users (requires instance owner role)
`n8n_get_user`	Get a user by ID or email
`n8n_delete_user`	Delete a user

Variables (3)

Tool	Description
`n8n_list_variables`	List all environment variables
`n8n_create_variable`	Create a key-value variable
`n8n_delete_variable`	Delete a variable

Projects (4) — Enterprise

Tool	Description
`n8n_list_projects`	List all projects
`n8n_create_project`	Create a project
`n8n_update_project`	Rename a project
`n8n_delete_project`	Delete a project

Audit (1)

Tool	Description
`n8n_generate_audit`	Generate a security audit (credentials, database, filesystem, nodes)

System (1)

Tool	Description
`n8n_health_check`	Verify n8n API connectivity

Webhooks (1)

Tool	Description
`n8n_trigger_webhook`	Trigger a workflow via its webhook URL (production or test)

⚙️ Configuration

Variable	Default	Description
`N8N_BASE_URL`	`http://localhost:5678`	Your n8n instance URL
`N8N_API_KEY`	—	API key (required)
`N8N_MAX_RETRIES`	`3`	Retry attempts on 429 / 5xx errors
`N8N_TIMEOUT`	`30000`	Request timeout in milliseconds

✨ Features

43 tools — the most comprehensive n8n MCP available
Data Tables — full CRUD, the only MCP with this support
Automatic retry — exponential backoff on rate limits (429) and server errors (5xx)
Configurable timeout — prevent hung requests (default 30s)
Zero external dependencies — only MCP SDK + Zod
TypeScript strict mode — fully typed, safe, and maintainable
Node 16+ compatible — native fetch with http/https fallback

🔒 Security

API keys are never hardcoded — loaded exclusively from environment variables
Credential data is redacted in list responses (n8n API behavior)
All IDs are sanitized with encodeURIComponent to prevent path traversal
No sensitive data is logged or exposed in error messages

🏗 Development

bash

git clone https://github.com/RPGMais/mcp-n8n.git
cd mcp-n8n
npm install

Command	Description
`npm run dev`	Run with tsx (no build step)
`npm run build`	Compile TypeScript to `dist/`
`npm start`	Run compiled version

Project structure

Code

mcp-n8n/
├── src/
│   ├── index.ts          # MCP server — tool registration and handlers
│   └── n8n-client.ts     # HTTP client — API calls, retry, timeout
├── dist/                  # Compiled output
├── package.json
├── tsconfig.json
└── README.md

🤝 Contributing

Contributions are welcome! Please:

Fork the repository
Create a feature branch (git checkout -b feat/my-feature)
Commit your changes
Push and open a Pull Request

📄 License

MIT — free for personal and commercial use.

Built by NexTool Solutions

If this project helps you, consider giving it a ⭐

Related MCP Servers

View all in Developer Tools View all alternatives

Frequently Asked Questions about N8n MCP Server

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "n8n-mcp-server": { "command": "npx", "args": ["-y", "n8n MCP Server"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/n8n-mcp-server?style=directory)](https://allmcps.com/mcp/n8n-mcp-server)

HTML Embed

<a href="https://allmcps.com/mcp/n8n-mcp-server"><img src="https://allmcps.com/api/badge/n8n-mcp-server?style=directory" alt="N8n MCP Server on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

0/5 checks healthy over the last 6h

27Quality signal: Emerging · 27/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership8/20

Documentation & tools11/30

Adoption & activity1/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to get the verified badge and attach your website.

Free dofollow backlink: after claiming, verify your product site and place a dofollow AllMCPs badge — we recheck it stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to N8n MCP Server →Install in Claude Desktop Install in Cursor Install in VS Code

N8n MCP Server

The most complete MCP server for n8n — 43 tools for workflows, data tables, and more.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Install Config Generator

Choose your client

claude_desktop_config.json

{
  "mcpServers": {
    "n8n-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "n8n-mcp-server"
      ]
    }
  }
}

💡 Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

Documentation Overview

mcp-n8n

The most complete MCP server for n8n

43 tools · Workflows · Data Tables · Tags · Credentials · Users · Webhooks · Audit

Quick Start · All 43 Tools · Configuration · Contributing

Why mcp-n8n?

Other n8n MCPs cover workflows and executions. mcp-n8n covers everything — including Data Tables, the only MCP to do so.

Feature	mcp-n8n	leonardsellem	illuminare	czlonkowski
Workflows (CRUD + execute)	10	7	8	4
Executions	3	5	3	2
Data Tables	8	—	—	—
Tags + Workflow Tags	7	—	5	—
Credentials	4	—	3	—
Users	3	—	4	—
Variables	3	—	3	—
Projects (Enterprise)	4	—	4	—
Security Audit	1	—	1	—
Webhooks	1	1	—	1
Health Check	1	—	—	1
Total	43	12	33	20

Data Tables — full CRUD with filters, search, upsert and dry-run. No other MCP has this.

🚀 Quick Start

Claude Code

Terminal

claude mcp add --scope user \
  -e N8N_BASE_URL=http://localhost:5678 \
  -e N8N_API_KEY=your-api-key \
  -- n8n npx -y @nextoolsolutions/mcp-n8n

Cursor

Add to ~/.cursor/mcp.json:

config.json

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": ["-y", "mcp-n8n"],
      "env": {
        "N8N_BASE_URL": "http://localhost:5678",
        "N8N_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json:

config.json

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": ["-y", "mcp-n8n"],
      "env": {
        "N8N_BASE_URL": "http://localhost:5678",
        "N8N_API_KEY": "your-api-key"
      }
    }
  }
}

Config file location:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Windsurf

Add to your Windsurf MCP config:

config.json

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": ["-y", "mcp-n8n"],
      "env": {
        "N8N_BASE_URL": "http://localhost:5678",
        "N8N_API_KEY": "your-api-key"
      }
    }
  }
}

VS Code (Copilot)

Add to your VS Code settings.json:

config.json

{
  "mcp": {
    "servers": {
      "n8n": {
        "command": "npx",
        "args": ["-y", "mcp-n8n"],
        "env": {
          "N8N_BASE_URL": "http://localhost:5678",
          "N8N_API_KEY": "your-api-key"
        }
      }
    }
  }
}

Getting your API key

Open your n8n instance
Go to Settings → n8n API
Create a new API key
Copy it into the N8N_API_KEY environment variable

🛠 Tools

Workflows (10)

Tool	Description
`n8n_list_workflows`	List all workflows with optional filters
`n8n_get_workflow`	Get a workflow by ID (includes nodes, connections, settings)
`n8n_create_workflow`	Create a new workflow from JSON
`n8n_update_workflow`	Update an existing workflow (full replacement)
`n8n_delete_workflow`	Permanently delete a workflow
`n8n_activate_workflow`	Activate a workflow for production
`n8n_deactivate_workflow`	Deactivate a workflow
`n8n_execute_workflow`	Trigger execution with optional input data
`n8n_get_workflow_tags`	List tags associated with a workflow
`n8n_update_workflow_tags`	Replace all tags on a workflow

Executions (3)

Tool	Description
`n8n_list_executions`	List executions with filters (workflow, status, cursor)
`n8n_get_execution`	Get execution status, result data and timing
`n8n_delete_execution`	Delete an execution record

Data Tables (8)

Only available in n8n v1.64+. This is the only MCP server with Data Tables support.

Tool	Description
`n8n_list_datatables`	List all data tables with filtering and sorting
`n8n_create_datatable`	Create a table with typed columns (string, number, boolean, date, json)
`n8n_get_datatable`	Get table metadata (columns, name, ID)
`n8n_get_datatable_rows`	Query rows with filter, full-text search, sorting and pagination
`n8n_insert_datatable_rows`	Insert one or more rows
`n8n_update_datatable_rows`	Update rows matching a filter (supports dry-run)
`n8n_upsert_datatable_row`	Update if exists, insert if not
`n8n_delete_datatable_rows`	Delete rows matching a filter (supports dry-run)

Tags (5)

Tool	Description
`n8n_list_tags`	List all tags
`n8n_get_tag`	Get a tag by ID
`n8n_create_tag`	Create a new tag
`n8n_update_tag`	Rename a tag
`n8n_delete_tag`	Delete a tag

Credentials (4)

Tool	Description
`n8n_list_credentials`	List credentials (names and types only — data is redacted)
`n8n_create_credential`	Create a credential (use `get_credential_schema` first)
`n8n_delete_credential`	Delete a credential
`n8n_get_credential_schema`	Get the JSON schema for a credential type

Users (3)

Tool	Description
`n8n_list_users`	List all users (requires instance owner role)
`n8n_get_user`	Get a user by ID or email
`n8n_delete_user`	Delete a user

Variables (3)

Tool	Description
`n8n_list_variables`	List all environment variables
`n8n_create_variable`	Create a key-value variable
`n8n_delete_variable`	Delete a variable

Projects (4) — Enterprise

Tool	Description
`n8n_list_projects`	List all projects
`n8n_create_project`	Create a project
`n8n_update_project`	Rename a project
`n8n_delete_project`	Delete a project

Audit (1)

Tool	Description
`n8n_generate_audit`	Generate a security audit (credentials, database, filesystem, nodes)

System (1)

Tool	Description
`n8n_health_check`	Verify n8n API connectivity

Webhooks (1)

Tool	Description
`n8n_trigger_webhook`	Trigger a workflow via its webhook URL (production or test)

⚙️ Configuration

Variable	Default	Description
`N8N_BASE_URL`	`http://localhost:5678`	Your n8n instance URL
`N8N_API_KEY`	—	API key (required)
`N8N_MAX_RETRIES`	`3`	Retry attempts on 429 / 5xx errors
`N8N_TIMEOUT`	`30000`	Request timeout in milliseconds

✨ Features

43 tools — the most comprehensive n8n MCP available
Data Tables — full CRUD, the only MCP with this support
Automatic retry — exponential backoff on rate limits (429) and server errors (5xx)
Configurable timeout — prevent hung requests (default 30s)
Zero external dependencies — only MCP SDK + Zod
TypeScript strict mode — fully typed, safe, and maintainable
Node 16+ compatible — native fetch with http/https fallback

🔒 Security

API keys are never hardcoded — loaded exclusively from environment variables
Credential data is redacted in list responses (n8n API behavior)
All IDs are sanitized with encodeURIComponent to prevent path traversal
No sensitive data is logged or exposed in error messages

🏗 Development

bash

git clone https://github.com/RPGMais/mcp-n8n.git
cd mcp-n8n
npm install

Command	Description
`npm run dev`	Run with tsx (no build step)
`npm run build`	Compile TypeScript to `dist/`
`npm start`	Run compiled version

Project structure

Code

mcp-n8n/
├── src/
│   ├── index.ts          # MCP server — tool registration and handlers
│   └── n8n-client.ts     # HTTP client — API calls, retry, timeout
├── dist/                  # Compiled output
├── package.json
├── tsconfig.json
└── README.md

🤝 Contributing

Contributions are welcome! Please:

Fork the repository
Create a feature branch (git checkout -b feat/my-feature)
Commit your changes
Push and open a Pull Request

📄 License

MIT — free for personal and commercial use.

Built by NexTool Solutions

If this project helps you, consider giving it a ⭐

Related MCP Servers

View all in Developer Tools View all alternatives

Frequently Asked Questions about N8n MCP Server

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "n8n-mcp-server": { "command": "npx", "args": ["-y", "n8n MCP Server"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/n8n-mcp-server?style=directory)](https://allmcps.com/mcp/n8n-mcp-server)

HTML Embed

<a href="https://allmcps.com/mcp/n8n-mcp-server"><img src="https://allmcps.com/api/badge/n8n-mcp-server?style=directory" alt="N8n MCP Server on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

0/5 checks healthy over the last 6h

27Quality signal: Emerging · 27/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership8/20

Documentation & tools11/30

Adoption & activity1/15

Community engagement0/10

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to get the verified badge and attach your website.

Free dofollow backlink: after claiming, verify your product site and place a dofollow AllMCPs badge — we recheck it stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to N8n MCP Server →Install in Claude Desktop Install in Cursor Install in VS Code