Skip to main content
Glama
andhit-r

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.

Install Server
A
license - permissive license
A
quality
A
maintenance

Maintenance

Maintainers
Response time
0dRelease cycle
6Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/andhit-r/n8n-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server