Skip to main content
Glama
n8n MCP Server

n8n MCP Server

by andhit-r

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

list_workflows

Daftar semua workflow

Workflow

get_workflow

Ambil detail satu workflow

Workflow

create_workflow

Buat workflow baru

Workflow

update_workflow

Perbarui workflow

Workflow

delete_workflow

Hapus workflow

Workflow

activate_workflow

Aktifkan workflow

Workflow

deactivate_workflow

Nonaktifkan workflow

Execution

list_executions

Daftar eksekusi (dengan filter)

Execution

get_execution

Ambil detail satu eksekusi

Execution

delete_execution

Hapus eksekusi

Credential

list_credentials

Daftar credentials

Credential

get_credential

Ambil detail credential

Credential

create_credential

Buat credential baru

Credential

delete_credential

Hapus credential

Tag

list_tags

Daftar semua tag

Tag

create_tag

Buat tag baru

Tag

update_tag

Perbarui nama tag

Tag

delete_tag

Hapus tag

Variable

list_variables

Daftar semua variable

Variable

create_variable

Buat variable baru

Variable

delete_variable

Hapus variable

Audit

get_audit_log

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/mcp

3. 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:latest

Dirilis 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

N8N_API_BASE_URL

Ya

http://localhost:5678/api/v1

N8N_API_KEY

Ya

n8n_api_xxx...

N8N_TIMEOUT

Tidak

30 (detik, default)

Otentikasi (Authentik)

Server memilih auth otomatis dari environment:

Mekanisme

Untuk

Aktif jika

OAuth Authentik

Claude Web / browser

AUTHENTIK_* + MCP_BASE_URL diisi

API Key statis

VS Code / CLI

MCP_API_KEY diisi

(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

MCP_TRANSPORT

stdio

stdio, http, atau sse

MCP_HOST / MCP_PORT

127.0.0.1 / 8000

bind saat http/sse

MCP_BASE_URL

—

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 tools
activate_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

    A4/5.0

    Scored across 22 tools

    Disambiguation5/5

    Every tool targets a distinct entity and action, with clear names like activate_workflow, create_credential, list_tags. No two tools have overlapping purposes.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      Provides seamless integration between MCP-compatible AI assistants and n8n workflow automation, enabling intelligent management and automation of n8n workflows through natural language.
      5
      -
    • A
      license
      A
      quality
      B
      maintenance
      Provides 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.
      20
      23 npm
      1
      MIT