n8n MCP Server

io.github.RPGMais由 GitHub 帳號 RPGMais 發布v2.0.2更新於 Oct 24, 2026

The most complete MCP server for n8n — 43 tools for workflows, data tables, and more.

已驗證STDIO僅桌面資料庫效率與工作流開發者工具

概覽

AI 產生的概覽

本機 MCP 伺服器，將助理連接到 n8n 實例，提供 43 個工具來管理工作流程、執行紀錄、資料表、標籤、憑證、使用者等。

可以做什麼
列出、檢視、建立、更新、刪除、啟用、停用並執行工作流程，讀取或取代其標籤。列出、檢視和刪除執行紀錄。建立和查詢資料表，插入、更新、upsert 或刪除列，更新和刪除支援試執行。管理標籤、憑證（建立、刪除、查詢 schema）、使用者、變數和企業版專案。透過 webhook 網址觸發工作流程，產生安全稽核，並執行健康檢查。
適用情境
適合已執行 n8n、希望助理在對話中建立、修改、執行或清理工作流程及其執行紀錄，或操作 n8n 資料表和實例管理而不必開啟 n8n 介面的情境。
執行需求
透過 npx 在本機執行，需要 Node.js。需要可連線的 n8n 實例網址，設定於 N8N_BASE_URL（預設 n8n API 金鑰，設定於 N8N_API_KEY，可在設定的 n8n API 頁面建立。選用 N8N_MAX_RETRIES 和 N8N_TIMEOUT。資料表需 n8n v1.64 以上；列出使用者需實例擁有者角色；專案僅限企業版。
安裝前請注意
此 API 金鑰可廣泛控制 n8n 實例。許多工具會寫入或刪除資料：工作流程、執行紀錄、標籤、憑證、使用者、變數、專案和資料表列都可能被刪除，工作流程還可被啟用或執行，可能觸發真實自動化。憑證清單只顯示名稱和類型，但建立憑證需要提供機密內容。N8N_BASE_URL 只應指向你信任的實例。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 n8n MCP Server，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

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.

Featuremcp-n8nleonardsellemilluminareczlonkowski
Workflows (CRUD + execute)10784
Executions3532
Data Tables8———
Tags + Workflow Tags7—5—
Credentials4—3—
Users3—4—
Variables3—3—
Projects (Enterprise)4—4—
Security Audit1—1—
Webhooks11—1
Health Check1——1
Total43123320

Data Tables — full CRUD with filters, search, upsert and dry-run. No other MCP has this.

🚀 Quick Start

Claude Code
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
Cursor

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"      }    }  }}
Claude Desktop

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
Windsurf

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"      }    }  }}
VS Code (Copilot)

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"        }      }    }  }}

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)

ToolDescription
n8n_list_workflowsList all workflows with optional filters
n8n_get_workflowGet a workflow by ID (includes nodes, connections, settings)
n8n_create_workflowCreate a new workflow from JSON
n8n_update_workflowUpdate an existing workflow (full replacement)
n8n_delete_workflowPermanently delete a workflow
n8n_activate_workflowActivate a workflow for production
n8n_deactivate_workflowDeactivate a workflow
n8n_execute_workflowTrigger execution with optional input data
n8n_get_workflow_tagsList tags associated with a workflow
n8n_update_workflow_tagsReplace all tags on a workflow

Executions (3)

ToolDescription
n8n_list_executionsList executions with filters (workflow, status, cursor)
n8n_get_executionGet execution status, result data and timing
n8n_delete_executionDelete an execution record

Data Tables (8)

Only available in n8n v1.64+. This is the only MCP server with Data Tables support.

ToolDescription
n8n_list_datatablesList all data tables with filtering and sorting
n8n_create_datatableCreate a table with typed columns (string, number, boolean, date, json)
n8n_get_datatableGet table metadata (columns, name, ID)
n8n_get_datatable_rowsQuery rows with filter, full-text search, sorting and pagination
n8n_insert_datatable_rowsInsert one or more rows
n8n_update_datatable_rowsUpdate rows matching a filter (supports dry-run)
n8n_upsert_datatable_rowUpdate if exists, insert if not
n8n_delete_datatable_rowsDelete rows matching a filter (supports dry-run)

Tags (5)

ToolDescription
n8n_list_tagsList all tags
n8n_get_tagGet a tag by ID
n8n_create_tagCreate a new tag
n8n_update_tagRename a tag
n8n_delete_tagDelete a tag

Credentials (4)

ToolDescription
n8n_list_credentialsList credentials (names and types only — data is redacted)
n8n_create_credentialCreate a credential (use get_credential_schema first)
n8n_delete_credentialDelete a credential
n8n_get_credential_schemaGet the JSON schema for a credential type

Users (3)

ToolDescription
n8n_list_usersList all users (requires instance owner role)
n8n_get_userGet a user by ID or email
n8n_delete_userDelete a user

Variables (3)

ToolDescription
n8n_list_variablesList all environment variables
n8n_create_variableCreate a key-value variable
n8n_delete_variableDelete a variable

Projects (4) — Enterprise

ToolDescription
n8n_list_projectsList all projects
n8n_create_projectCreate a project
n8n_update_projectRename a project
n8n_delete_projectDelete a project

Audit (1)

ToolDescription
n8n_generate_auditGenerate a security audit (credentials, database, filesystem, nodes)

System (1)

ToolDescription
n8n_health_checkVerify n8n API connectivity

Webhooks (1)

ToolDescription
n8n_trigger_webhookTrigger a workflow via its webhook URL (production or test)

⚙️ Configuration

VariableDefaultDescription
N8N_BASE_URLhttp://localhost:5678Your n8n instance URL
N8N_API_KEY—API key (required)
N8N_MAX_RETRIES3Retry attempts on 429 / 5xx errors
N8N_TIMEOUT30000Request 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

bash
git clone https://github.com/NexTools-Solutions/mcp-n8n.gitcd mcp-n8nnpm install
CommandDescription
npm run devRun with tsx (no build step)
npm run buildCompile TypeScript to dist/
npm startRun 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 ⭐

來源：README.md，提交 f443f4e

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v2.0.2最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分