README.md
n8n Management MCP Server
MCP (Model Context Protocol) server for connecting AI assistants to your n8n instance. Manage workflows, executions, credentials, tags, variables, and users through 31 tools.
Works with Claude Desktop, Cursor, VS Code, and any MCP client.
Quick Start
Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"n8n": {
"command": "npx",
"args": ["-y", "@node2flow/n8n-management-mcp"],
"env": {
"N8N_URL": "https://your-n8n-instance.com",
"N8N_API_KEY": "your-n8n-api-key"
}
}
}
}
Cursor / VS Code
Add to MCP settings:
{
"mcpServers": {
"n8n": {
"command": "npx",
"args": ["-y", "@node2flow/n8n-management-mcp"],
"env": {
"N8N_URL": "https://your-n8n-instance.com",
"N8N_API_KEY": "your-n8n-api-key"
}
}
}
}
HTTP Mode (Streamable HTTP)
For remote deployment or shared access:
N8N_URL=https://your-n8n.com N8N_API_KEY=your_key npx @node2flow/n8n-management-mcp --http
Server starts on port 3000 (configurable via PORT env var). MCP endpoint: http://localhost:3000/mcp
Configuration
| Environment Variable | Required | Description |
|---|---|---|
N8N_URL |
Yes | URL of your n8n instance (e.g. https://n8n.example.com) |
N8N_API_KEY |
Yes | n8n API key (how to create) |
PORT |
No | Port for HTTP server (default: 3000, only used with --http) |
All Tools (31 tools)
Workflow Management (10 tools)
| Tool | Description |
|---|---|
n8n_list_workflows |
List all workflows with status and tags |
n8n_get_workflow |
Get workflow details (nodes, connections) |
n8n_create_workflow |
Create a new workflow |
n8n_update_workflow |
Update workflow structure |
n8n_delete_workflow |
Permanently delete a workflow |
n8n_activate_workflow |
Activate workflow triggers |
n8n_deactivate_workflow |
Deactivate workflow triggers |
n8n_execute_workflow |
Execute a workflow with input data |
n8n_get_workflow_tags |
Get tags assigned to a workflow |
n8n_update_workflow_tags |
Update workflow tags |
Execution History (4 tools)
| Tool | Description |
|---|---|
n8n_list_executions |
List execution history (filter by workflow) |
n8n_get_execution |
Get execution details with node outputs |
n8n_delete_execution |
Delete an execution record |
n8n_retry_execution |
Retry a failed execution |
Credentials (4 tools)
| Tool | Description |
|---|---|
n8n_create_credential |
Store API credentials |
n8n_update_credential |
Update credential data |
n8n_delete_credential |
Delete a credential |
n8n_get_credential_schema |
Get required fields for a credential type |
Tags (5 tools)
| Tool | Description |
|---|---|
n8n_list_tags |
List all tags |
n8n_get_tag |
Get tag details |
n8n_create_tag |
Create a new tag |
n8n_update_tag |
Rename a tag |
n8n_delete_tag |
Delete a tag |
Variables (4 tools)
| Tool | Description |
|---|---|
n8n_list_variables |
List all environment variables |
n8n_create_variable |
Create a global variable |
n8n_update_variable |
Update a variable value |
n8n_delete_variable |
Delete a variable |
User Management (4 tools)
| Tool | Description |
|---|---|
n8n_list_users |
List all users (owner only) |
n8n_get_user |
Get user details |
n8n_delete_user |
Delete a user |
n8n_update_user_role |
Change user role |
Requirements
- Node.js 18+
- n8n instance with API enabled
- n8n API key
How to Create an n8n API Key
- Go to your n8n instance Settings
- Select API > API Keys
- Click Create API key
- Copy the key and use it as
N8N_API_KEY
For Developers
git clone https://github.com/node2flow-th/n8n-management-mcp-community.git
cd n8n-management-mcp-community
npm install
npm run build
# Run in stdio mode
N8N_URL=https://your-n8n.com N8N_API_KEY=your_key npm start
# Run in dev mode (hot reload)
N8N_URL=https://your-n8n.com N8N_API_KEY=your_key npm run dev
# Run in HTTP mode
N8N_URL=https://your-n8n.com N8N_API_KEY=your_key npm start -- --http
License
MIT License - see LICENSE
Copyright (c) 2026 Node2Flow
Links
- npm Package
- n8n Documentation
- MCP Protocol
- [Node2Flow](https://node2flow.n
Tools 31
n8n_list_workflowsList all workflows with status and tagsn8n_get_workflowGet workflow details including nodes and connectionsn8n_create_workflowCreate a new workflown8n_update_workflowUpdate workflow structuren8n_delete_workflowPermanently delete a workflown8n_activate_workflowActivate workflow triggersn8n_deactivate_workflowDeactivate workflow triggersn8n_execute_workflowExecute a workflow with input datan8n_get_workflow_tagsGet tags assigned to a workflown8n_update_workflow_tagsUpdate workflow tagsn8n_list_executionsList execution history filtered by workflown8n_get_executionGet execution details with node outputsn8n_delete_executionDelete an execution recordn8n_retry_executionRetry a failed executionn8n_create_credentialStore API credentialsn8n_update_credentialUpdate credential datan8n_delete_credentialDelete a credentialn8n_get_credential_schemaGet required fields for a credential typen8n_list_tagsList all tagsn8n_get_tagGet tag detailsn8n_create_tagCreate a new tagn8n_update_tagRename a tagn8n_delete_tagDelete a tagn8n_list_variablesList all environment variablesn8n_create_variableCreate a global variablen8n_update_variableUpdate a variable valuen8n_delete_variableDelete a variablen8n_list_usersList all usersn8n_get_userGet user detailsn8n_delete_userDelete a usern8n_update_user_roleChange user roleEnvironment Variables
N8N_URLrequiredURL of your n8n instanceN8N_API_KEYrequiredn8n API key for authenticationPORTPort for HTTP server (default: 3000)Try it
→List all my active workflows and tell me which ones have failed in the last 24 hours.
→Find the workflow named 'Lead Generation' and trigger it with this JSON payload.
→Check the execution history for the 'Data Sync' workflow and retry the last failed execution.
→List all global variables currently defined in my n8n instance.
→Create a new tag called 'Production' and assign it to the 'Main API' workflow.