Skip to main content
Glama

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/NexTools-Solutions/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 ⭐

Available Tools

43 tools
n8n_activate_workflowActivate workflowA

Activate a workflow for production. Requires at least one trigger node.

Inputs: workflowId (required). Returns: object

n8n_create_credentialCreate credentialB

Create a new credential. Use n8n_get_credential_schema to discover the required fields for a type.

Inputs: name (required), type (required), data (required). Returns: object

n8n_create_datatableCreate data tableB

Create a data table with typed columns (string, number, boolean, date, json).

Inputs: name (required), columns (required). Returns: object

n8n_create_projectCreate projectC

Create a new project (Enterprise feature).

Inputs: name (required). Returns: object

n8n_create_tagCreate tagB

Create a new tag with the given name.

Inputs: name (required). Returns: object

n8n_create_variableCreate variableC

Create a new environment variable in n8n (key-value pair).

Inputs: key (required), value (required). Returns: object

n8n_create_workflowCreate workflowB

Create a new workflow. Provide the workflow JSON (name, nodes, connections, settings).

Inputs: workflow (required). Returns: object

n8n_deactivate_workflowDeactivate workflowA

Deactivate a workflow (stops listening for triggers).

Inputs: workflowId (required). Returns: object

n8n_delete_credentialDelete credentialA

Permanently delete a credential by ID.

Inputs: credentialId (required). Returns: ok

n8n_delete_datatable_rowsDelete data table rowsC

Delete rows matching a filter. The filter is required (JSON string).

Inputs: dataTableId (required), filter (required), returnData, dryRun. Returns: object

n8n_delete_executionDelete executionB

Permanently delete an execution record by ID.

Inputs: executionId (required). Returns: ok

n8n_delete_projectDelete projectB

Delete a project by ID (Enterprise feature).

Inputs: projectId (required). Returns: ok

n8n_delete_tagDelete tagB

Delete a tag by ID. This does not affect workflows that used this tag.

Inputs: tagId (required). Returns: ok

n8n_delete_userDelete userA

Delete a user by ID (requires owner role). Workflows owned by this user must be transferred first.

Inputs: userId (required). Returns: ok

n8n_delete_variableDelete variableB

Delete an environment variable by ID.

Inputs: variableId (required). Returns: ok

n8n_delete_workflowDelete workflowA

Permanently delete a workflow by ID.

Inputs: workflowId (required). Returns: ok

n8n_execute_workflowExecute workflowB

Trigger a workflow execution. Optionally send input data.

Inputs: workflowId (required), data. Returns: executionId, status

n8n_generate_auditSecurity auditB

Generate a security audit report for the n8n instance. Categories: credentials, database, filesystem, instance, nodes.

Inputs: categories, daysAbandonedWorkflow. Returns: object

n8n_get_credential_schemaGet credential schemaA

Get the JSON schema for a credential type, showing required and optional fields.

Inputs: typeName (required). Returns: object

n8n_get_datatableGet data tableA

Retrieve metadata (columns, name, ID) of a data table.

Inputs: dataTableId (required). Returns: object

n8n_get_datatable_rowsQuery data table rowsB

List rows from a data table with optional filter, search, sorting and pagination. Filter is a JSON string with {type, filters} structure.

Inputs: dataTableId (required), limit, cursor, filter, +2 more. Returns: data, nextCursor

n8n_get_executionGet executionB

Get the status and result data of a specific execution.

Inputs: executionId (required). Returns: object

n8n_get_tagGet tagA

Retrieve a tag by ID.

Inputs: tagId (required). Returns: object

n8n_get_userGet userA

Retrieve a user by ID or email.

Inputs: idOrEmail (required). Returns: object

n8n_get_workflowGet workflowA

Retrieve a workflow by ID, including nodes, connections and settings.

Inputs: workflowId (required). Returns: object

n8n_get_workflow_tagsGet workflow tagsB

List all tags associated with a specific workflow.

Inputs: workflowId (required). Returns: object

n8n_health_checkHealth checkA

Check connectivity to the n8n instance and verify the API is reachable.

Inputs: no named parameters. Returns: object

n8n_insert_datatable_rowsInsert data table rowsC

Insert one or more rows. Each row is an object with column names as keys.

Inputs: dataTableId (required), data (required), returnType. Returns: object

n8n_list_credentialsList credentialsA

List all credentials (names and types only — data is redacted).

Inputs: limit, cursor. Returns: object

n8n_list_datatablesList data tablesA

List data tables with optional filtering, sorting and pagination.

Inputs: limit, cursor, filter, sortBy. Returns: object

n8n_list_executionsList executionsA

List workflow executions. Filter by workflowId, status, limit and cursor.

Inputs: workflowId, limit, cursor, status. Returns: data, nextCursor

n8n_list_projectsList projectsB

List all projects (Enterprise feature).

Inputs: limit, cursor. Returns: object

n8n_list_tagsList tagsB

List all tags in the n8n instance.

Inputs: limit. Returns: object

n8n_list_usersList usersB

List all users in the n8n instance (requires owner role).

Inputs: limit, cursor, includeRole. Returns: object

n8n_list_variablesList variablesC

List all environment variables stored in n8n.

Inputs: limit, cursor. Returns: object

n8n_list_workflowsList workflowsB

List all workflows. Optionally filter by active status and limit results.

Inputs: active, limit. Returns: data, nextCursor

n8n_trigger_webhookTrigger webhookA

Trigger a workflow via its webhook URL. Use isTest=true for test webhooks. The webhookPath is the path configured in the Webhook node.

Inputs: webhookPath (required), method, data, headers, +1 more. Returns: object

n8n_update_datatable_rowsUpdate data table rowsC

Update rows matching a filter. Conditions: eq, neq, like, ilike, gt, gte, lt, lte.

Inputs: dataTableId (required), filter (required), data (required), returnData, +1 more. Returns: object

n8n_update_projectUpdate projectB

Rename an existing project (Enterprise feature).

Inputs: projectId (required), name (required). Returns: object

n8n_update_tagUpdate tagC

Rename an existing tag.

Inputs: tagId (required), name (required). Returns: object

n8n_update_workflowUpdate workflowA

Update an existing workflow. Send the complete workflow object (get it first with n8n_get_workflow).

Inputs: workflowId (required), workflow (required). Returns: object

n8n_update_workflow_tagsUpdate workflow tagsA

Replace all tags on a workflow. Send an array of tag IDs.

Inputs: workflowId (required), tagIds (required). Returns: object

n8n_upsert_datatable_rowUpsert data table rowB

Update a row if it exists (by filter) or insert a new one.

Inputs: dataTableId (required), filter (required), data (required), returnData, +1 more. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 43 tools

    Disambiguation5/5

    All 43 tools target distinct resource-action pairs. There is no overlap; each tool has a clear, unique purpose (e.g., create vs. execute vs. activate workflow).

    Naming Consistency5/5

    All tools follow the 'n8n_verb_noun' pattern in snake_case. Verbs are consistent (create, get, list, update, delete, etc.) with only minor singular/plural variance (e.g., upsert_datatable_row vs. insert_datatable_rows).

    Tool Count4/5

    43 tools is high but justified given n8n's broad feature set (workflows, credentials, data tables, tags, variables, projects, users, executions, audits). Slightly above typical recommended range but well-scoped.

    Completeness3/5

    Covers core CRUD for many resources but has notable gaps: missing update for credentials, variables, and projects; no delete_datatable; no create_user. Basic lifecycle coverage is incomplete.

    Maintenance

    ActivitySlowing
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables full workflow automation management in n8n through 40+ tools covering workflows, executions, credentials, tags, variables, projects, users, and source control operations.
      52
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Enables AI assistants to interact with n8n workflow automation instances through the REST API. Supports workflow management, execution control, tag organization, execution history monitoring, and webhook management.
      19
      128 npm
      5
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to manage n8n workflow automation instances through tools for workflow CRUD operations, execution monitoring, and webhook triggering. It facilitates programmatic interaction with n8n instances via the n8n API with AI-optimized descriptions and error handling.
      63
      MIT