n8n MCP Server
Provides tools to manage n8n workflows, executions, credentials, tags, variables, and audit logs via the n8n REST 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., "@n8n MCP Server list all workflows"
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.
n8n MCP Server
MCP Server untuk n8n REST API, dibangun dengan FastMCP. Ekspos tool untuk mengelola workflows, executions, credentials, tags, dan variables langsung dari MCP client (Claude Desktop, Claude Code, Claude Web).
Dipakai lewat tiga kanal: stdio, Claude Code, dan Claude Web (claude.ai). Otentikasi memakai Authentik sebagai identity provider (untuk Claude Web).
Tools yang tersedia
Kategori | Tool | Deskripsi |
Workflow |
| Daftar semua workflow |
Workflow |
| Ambil detail satu workflow |
Workflow |
| Buat workflow baru |
Workflow |
| Perbarui workflow |
Workflow |
| Hapus workflow |
Workflow |
| Aktifkan workflow |
Workflow |
| Nonaktifkan workflow |
Execution |
| Daftar eksekusi (dengan filter) |
Execution |
| Ambil detail satu eksekusi |
Execution |
| Hapus eksekusi |
Credential |
| Daftar credentials |
Credential |
| Ambil detail credential |
Credential |
| Buat credential baru |
Credential |
| Hapus credential |
Tag |
| Daftar semua tag |
Tag |
| Buat tag baru |
Tag |
| Perbarui nama tag |
Tag |
| Hapus tag |
Variable |
| Daftar semua variable |
Variable |
| Buat variable baru |
Variable |
| Hapus variable |
Audit |
| Ambil audit log n8n |
Related MCP server: N8N MCP Server
Cara pakai per kanal
1. stdio — Claude Desktop / Claude Code lokal
Tidak perlu auth jaringan; client men-spawn proses langsung.
{
"mcpServers": {
"n8n-mcp": {
"command": "uvx",
"args": ["--from", "git+https://github.com/andhit-r/n8n-mcp@v0.1.0", "n8n-mcp"],
"env": {
"N8N_API_BASE_URL": "http://localhost:5678/api/v1",
"N8N_API_KEY": "your-n8n-api-key"
}
}
}
}Atau via Docker (stdio):
{
"mcpServers": {
"n8n-mcp": {
"command": "docker",
"args": [
"run", "--rm", "-i",
"-e", "MCP_TRANSPORT=stdio",
"-e", "N8N_API_BASE_URL=http://host.docker.internal:5678/api/v1",
"-e", "N8N_API_KEY=your-n8n-api-key",
"ghcr.io/andhit-r/n8n-mcp:latest"
]
}
}
}2. Claude Code
# stdio (langsung, tanpa server terpisah)
claude mcp add n8n-mcp -- uvx --from "git+https://github.com/andhit-r/n8n-mcp@v0.1.0" n8n-mcp
# remote (server HTTP yang sudah berjalan)
claude mcp add --transport http n8n-mcp https://n8n-mcp.example.com/mcp3. Claude Web (claude.ai) — remote, WAJIB OAuth Authentik
Jalankan server sebagai service HTTP di URL publik HTTPS, daftarkan sebagai Custom Connector di claude.ai.
docker run -d -p 8000:8000 \
-e N8N_API_BASE_URL=https://your-n8n.example.com/api/v1 \
-e N8N_API_KEY=your-n8n-api-key \
-e MCP_BASE_URL=https://n8n-mcp.example.com \
-e AUTHENTIK_BASE_URL=https://auth.example.com \
-e AUTHENTIK_APP_SLUG=n8n-mcp \
-e AUTHENTIK_CLIENT_ID=... \
-e AUTHENTIK_CLIENT_SECRET=... \
ghcr.io/andhit-r/n8n-mcp:latestDirilis via GitHub (GitHub Release + image GHCR). Tidak tersedia di PyPI. Install dari sumber:
pip install "git+https://github.com/andhit-r/n8n-mcp@v0.1.0".
Konfigurasi n8n API
Aktifkan Public REST API di n8n: Settings → n8n API → Create an API key. Pastikan akun memiliki izin yang sesuai (admin direkomendasikan).
Variabel | Wajib | Contoh |
| Ya |
|
| Ya |
|
| Tidak |
|
Otentikasi (Authentik)
Server memilih auth otomatis dari environment:
Mekanisme | Untuk | Aktif jika |
OAuth Authentik | Claude Web / browser |
|
API Key statis | VS Code / CLI |
|
(tanpa auth) | stdio / jaringan lokal | tidak ada yang diisi |
Buat OAuth2/OIDC Provider + Application di Authentik (Redirect URI
https://<MCP_BASE_URL>/auth/callback, scope openid profile email).
Transport (environment)
Variabel | Default | Keterangan |
|
|
|
|
| bind saat http/sse |
| — | URL publik (wajib untuk OAuth Authentik) |
Deployment cloud: uvicorn n8n_mcp.asgi:app --host 0.0.0.0 --port 8000.
Pengembangan
pip install -e .
cp .env.example .env # isi N8N_API_BASE_URL dan N8N_API_KEY
python -m n8n_mcp # jalankan lokal (stdio)
make test # gate test (lint + unit)Lisensi
MIT.
Available Tools
22 toolsactivate_workflowA
Aktifkan workflow di n8n agar mulai memproses trigger.
Setelah diaktifkan, workflow akan merespons trigger (webhook, schedule, dll) secara otomatis. Pastikan workflow sudah memiliki trigger node.
Inputs: workflow_id (required). Returns: object
create_credentialA
Buat credential baru di n8n.
Tipe credential dan skema data-nya bergantung pada integrasi n8n.
Contoh: tipe githubApi memerlukan {"accessToken": "ghp_xxx"}.
Lihat dokumentasi node n8n untuk skema data per tipe.
Inputs: name (required), credential_type (required), data (required). Returns: object
create_tagB
Buat tag baru di n8n.
Tag dapat digunakan untuk mengkategorikan workflow sehingga mudah difilter. Nama tag harus unik.
Inputs: name (required). Returns: object
create_variableA
Buat variable baru di n8n (fitur Enterprise).
Variable bisa diakses di workflow via ekspresi {{ $vars.NAMA_VAR }}.
Kunci harus unik dan hanya boleh berisi huruf, angka, dan underscore.
Inputs: key (required), value (required). Returns: object
create_workflowA
Buat workflow baru di n8n.
Workflow dibuat dalam keadaan nonaktif. Gunakan activate_workflow untuk mengaktifkannya.
Format node dan koneksi mengikuti skema n8n (lihat dokumentasi n8n API).
Inputs: name (required), nodes (required), connections (required), settings, +1 more. Returns: object
deactivate_workflowA
Nonaktifkan workflow di n8n sehingga berhenti memproses trigger.
Setelah dinonaktifkan, workflow tidak akan merespons trigger baru. Eksekusi yang sedang berjalan tidak akan dihentikan.
Inputs: workflow_id (required). Returns: object
delete_credentialA
Hapus credential dari n8n secara permanen.
Operasi ini tidak dapat dibatalkan. Workflow yang menggunakan credential ini akan gagal bila dieksekusi setelah credential dihapus.
Inputs: credential_id (required). Returns: object
delete_executionA
Hapus rekaman eksekusi dari n8n secara permanen.
Operasi ini tidak dapat dibatalkan. Eksekusi yang sedang berjalan tidak bisa dihapus.
Inputs: execution_id (required). Returns: object
delete_tagA
Hapus tag dari n8n.
Tag yang dihapus akan dilepas dari semua workflow yang menggunakannya. Workflow tidak ikut terhapus.
Inputs: tag_id (required). Returns: object
delete_variableA
Hapus variable dari n8n secara permanen.
Workflow yang mereferensikan variable ini mungkin akan error setelah dihapus.
Inputs: variable_id (required). Returns: object
delete_workflowA
Hapus workflow dari n8n secara permanen.
Operasi ini tidak dapat dibatalkan. Workflow yang sedang aktif akan dihentikan terlebih dahulu sebelum dihapus.
Inputs: workflow_id (required). Returns: object
get_audit_logA
Ambil audit log aktivitas di n8n (fitur Enterprise).
Mengembalikan rekaman aktivitas pengguna dan sistem seperti pembuatan/penghapusan workflow, login, perubahan credential, dll. Memerlukan lisensi n8n Enterprise.
Inputs: days_ago, resource_type. Returns: object
get_credentialA
Ambil metadata satu credential berdasarkan ID.
Nilai sensitif (token, password, secret key) tidak dikembalikan oleh n8n API demi keamanan. Hanya metadata seperti name, type, dan createdAt yang tersedia.
Inputs: credential_id (required). Returns: object
get_executionA
Ambil detail lengkap satu eksekusi workflow.
Mengembalikan informasi eksekusi termasuk status, waktu mulai/selesai, dan (opsional) data input/output tiap node.
Inputs: execution_id (required), include_data. Returns: object
get_workflowA
Ambil detail lengkap satu workflow berdasarkan ID.
Mengembalikan definisi workflow termasuk nodes, connections, dan pengaturan.
Inputs: workflow_id (required). Returns: object
list_credentialsA
Ambil daftar credentials yang tersimpan di n8n.
Data sensitif (token, password) tidak dikembalikan oleh API. Hanya metadata credential (id, name, type, createdAt) yang tersedia.
Inputs: credential_type, limit, cursor. Returns: object
list_executionsB
Ambil daftar eksekusi workflow di n8n.
Mendukung filter berdasarkan workflow, status, dan paginasi. Data eksekusi
(input/output node) hanya disertakan bila include_data=True.
Inputs: workflow_id, status, limit, cursor, +1 more. Returns: object
list_tagsB
Ambil daftar semua tag yang tersedia di n8n.
Tag digunakan untuk mengkategorikan dan memfilter workflow.
Inputs: limit, cursor. Returns: object
list_variablesA
Ambil daftar semua variable n8n (fitur Enterprise).
Variable n8n adalah pasangan key-value yang bisa diakses dari semua workflow. Fitur ini memerlukan lisensi n8n Enterprise atau Self-hosted dengan fitur variable aktif.
Inputs: limit, cursor. Returns: object
list_workflowsA
Ambil daftar semua workflow di n8n.
Mendukung filter berdasarkan status aktif, tag, dan nama workflow.
Hasil di-paginate; gunakan cursor dari nextCursor respons untuk halaman berikutnya.
Inputs: active, tags, name, limit, +1 more. Returns: object
update_tagB
Perbarui nama tag yang sudah ada di n8n.
Inputs: tag_id (required), name (required). Returns: object
update_workflowA
Perbarui workflow yang sudah ada di n8n.
Hanya field yang diisi yang akan diperbarui. Minimal berikan salah satu field. Perbarui nodes dan connections sekaligus bila mengubah struktur workflow.
Inputs: workflow_id (required), name, nodes, connections, +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 22 tools
Every tool targets a distinct entity and action, with clear names like activate_workflow, create_credential, list_tags. No two tools have overlapping purposes.
All tool names follow the verb_noun pattern with snake_case, e.g., activate_workflow, delete_credential. The naming is perfectly consistent across all 22 tools.
22 tools cover multiple entity types (workflows, credentials, tags, variables, executions, audit logs) with CRUD and lifecycle operations. The count is well-scoped for a workflow automation server.
The tool set covers most core operations, but lacks update endpoints for credentials and variables (although these may be limited by n8n API design). Minor gap; overall surface is complete.
Maintenance
Related MCP Connectors
Build and run AI workflows, agents, data tables and 1000+ API integrations from any MCP client.
Create, browse, remix, collaborate on, and run durable AI workflow nodes from MCP hosts.
Zero-setup MCP gateway securely connecting AI to your tools with authentication and workflows
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Related MCP Servers
- -licenseNot gradedqualityNot gradedmaintenanceProvides seamless integration between MCP-compatible AI assistants and n8n workflow automation, enabling intelligent management and automation of n8n workflows through natural language.5-
- AlicenseNot gradedqualityDmaintenanceEnables Claude Desktop to integrate with n8n workflow automation platform through a centralized MCP server. Provides seamless connection to n8n instances for workflow management and automation tasks.148 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables management of multiple N8N workflow automation instances through MCP. Supports listing, creating, updating, deleting, executing workflows and monitoring their executions across different N8N environments.148 npmMIT
- AlicenseAqualityBmaintenanceProvides ops-focused n8n tools for MCP-compatible agents, enabling listing, inspecting, triggering, validating, managing tags, running security audits, and safely editing n8n workflows with auto-backup and confirm gates.2023 npm1MIT