mcp-n8n
mcp-n8n is an MCP server that gives AI assistants full control over an n8n instance through 43 tools covering workflows, executions, data tables, tags, credentials, users, variables, projects, webhooks, audits, and health checks.
Workflows (10) — list, get, create, update, delete, activate/deactivate, execute with input data, and read/replace workflow tags
Executions (3) — list with filters (workflow, status, cursor), inspect status/result/timing, delete records
Data Tables (8) — list, create typed tables, inspect metadata, query rows (filter, full-text search, sort, paginate), insert, update, upsert, and delete rows with dry-run support (n8n v1.64+, unique to this MCP)
Tags (5) — list, get, create, rename, delete
Credentials (4) — list (redacted), create, delete, and fetch credential-type schemas
Users (3) — list, get by ID/email, delete (owner role required)
Variables (3) — list, create, delete environment variables
Projects (4, Enterprise) — list, create, rename, delete
Audit (1) — generate security audits across credentials, database, filesystem, instance, and nodes
System (1) — health check for n8n API connectivity
Webhooks (1) — trigger workflows via production or test webhook URLs with custom method, headers, and body
Provides comprehensive tools for managing n8n workflows, executions, data tables, tags, credentials, users, variables, projects, audit, and webhooks via the n8n API.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-n8n list all workflows with status 'active'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
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-n8nAdd 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.jsonWindows:
%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
Open your n8n instance
Go to Settings → n8n API
Create a new API key
Copy it into the
N8N_API_KEYenvironment variable
🛠 Tools
Workflows (10)
Tool | Description |
| List all workflows with optional filters |
| Get a workflow by ID (includes nodes, connections, settings) |
| Create a new workflow from JSON |
| Update an existing workflow (full replacement) |
| Permanently delete a workflow |
| Activate a workflow for production |
| Deactivate a workflow |
| Trigger execution with optional input data |
| List tags associated with a workflow |
| Replace all tags on a workflow |
Executions (3)
Tool | Description |
| List executions with filters (workflow, status, cursor) |
| Get execution status, result data and timing |
| 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 |
| List all data tables with filtering and sorting |
| Create a table with typed columns (string, number, boolean, date, json) |
| Get table metadata (columns, name, ID) |
| Query rows with filter, full-text search, sorting and pagination |
| Insert one or more rows |
| Update rows matching a filter (supports dry-run) |
| Update if exists, insert if not |
| Delete rows matching a filter (supports dry-run) |
Tags (5)
Tool | Description |
| List all tags |
| Get a tag by ID |
| Create a new tag |
| Rename a tag |
| Delete a tag |
Credentials (4)
Tool | Description |
| List credentials (names and types only — data is redacted) |
| Create a credential (use |
| Delete a credential |
| Get the JSON schema for a credential type |
Users (3)
Tool | Description |
| List all users (requires instance owner role) |
| Get a user by ID or email |
| Delete a user |
Variables (3)
Tool | Description |
| List all environment variables |
| Create a key-value variable |
| Delete a variable |
Projects (4) — Enterprise
Tool | Description |
| List all projects |
| Create a project |
| Rename a project |
| Delete a project |
Audit (1)
Tool | Description |
| Generate a security audit (credentials, database, filesystem, nodes) |
System (1)
Tool | Description |
| Verify n8n API connectivity |
Webhooks (1)
Tool | Description |
| Trigger a workflow via its webhook URL (production or test) |
⚙️ Configuration
Variable | Default | Description |
|
| Your n8n instance URL |
| — | API key (required) |
|
| Retry attempts on 429 / 5xx errors |
|
| 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
encodeURIComponentto prevent path traversalNo sensitive data is logged or exposed in error messages
🏗 Development
git clone https://github.com/NexTools-Solutions/mcp-n8n.git
cd mcp-n8n
npm installCommand | Description |
| Run with tsx (no build step) |
| Compile TypeScript to |
| 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:
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 ⭐
Available Tools
43 toolsn8n_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
Scored across 43 tools
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).
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).
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.
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
Related MCP Connectors
n8n MCP — query your own n8n instance (BYO).
Know when your n8n workflows, URLs, and AI apps break, before your customers do.
Free public n8n, AI support and software acceptance templates; scoped private delivery workflows.
26 pay-per-call AI agent tools for marketing, sales, content, research, verification, and integration testing. Agents pay per call via x402 micropayments (USDC on Base), raw JSON in and out. Includes delivery-acceptance receipts (ACCEPT/REJECT/REVIEW), a webhook capture/replay/conformance lab, and n8n workflow validation with bounded JSON-Patch repair.
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceProvides 43 tools for complete Supabase control including database operations, storage management, authentication, edge functions, and admin tasks through an HTTP API designed for n8n integration.-
- AlicenseAqualityDmaintenanceEnables full workflow automation management in n8n through 40+ tools covering workflows, executions, credentials, tags, variables, projects, users, and source control operations.52MIT
- AlicenseBqualityCmaintenanceEnables 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.19128 npm5MIT
- AlicenseNot gradedqualityDmaintenanceEnables 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.63MIT