Skip to main content
Glama
RPGMais

mcp-n8n

by RPGMais
OverviewSchemaRelated ServersScoreDiscussions
JavaScript
Remote

mcp-n8n

The most complete MCP server for n8n

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

npm License: MIT Node.js TypeScript MCP SDK

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.

Related MCP server: n8n MCP Server

🚀 Quick Start

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

Add to ~/.cursor/mcp.json:

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

Add to claude_desktop_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

Add to your Windsurf MCP config:

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

Add to your VS Code settings.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

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

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

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:

  1. Fork the repository

  2. Create a feature branch (git checkout -b feat/my-feature)

  3. Commit your changes

  4. 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 ⭐

Install Server
A
license - permissive license
A
quality
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/RPGMais/mcp-n8n'

If you have feedback or need assistance with the MCP directory API, please join our Discord server