n8n MCP Server

Install

Config snippet generator goes here (5 client tabs)

README

<div align="center">

# mcp-n8n

**The most complete MCP server for [n8n](https://n8n.io)**

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

[![npm](https://img.shields.io/npm/v/@nextoolsolutions/mcp-n8n.svg)](https://www.npmjs.com/package/@nextoolsolutions/mcp-n8n)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Node.js](https://img.shields.io/badge/Node.js-≥18-green.svg)](https://nodejs.org/)
[![TypeScript](https://img.shields.io/badge/TypeScript-Strict-blue.svg)](https://www.typescriptlang.org/)
[![MCP SDK](https://img.shields.io/badge/MCP_SDK-1.25-purple.svg)](https://modelcontextprotocol.io/)

[Quick Start](#-quick-start) · [All 43 Tools](#-tools) · [Configuration](#%EF%B8%8F-configuration) · [Contributing](#-contributing)

</div>

---

## 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

<details open>
<summary><strong>Claude Code</strong></summary>

```bash
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
```

</details>

<details>
<summary><strong>Cursor</strong></summary>

Add to `~/.cursor/mcp.json`:

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

</details>

<details>
<summary><strong>Claude Desktop</strong></summary>

Add to `claude_desktop_config.json`:

```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`

</details>

<details>
<summary><strong>Windsurf</strong></summary>

Add to your Windsurf MCP config:

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

</details>

<details>
<summary><strong>VS Code (Copilot)</strong></summary>

Add to your VS Code `settings.json`:

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

</details>

### Getting your API key

1. Open your n8n instance
2. Go to **Settings → n8n API**
3. Create a new API key
4. 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_ge