docs-n8n-mcp

Local MCP server exposing the official n8n documentation and workflow templates to LLM agents via the Model Context Protocol.

Tools

Documentation (local cache)

Tool	Description
list_docs(category?)	List all doc pages (~1,500). Optional category filter (core-nodes, app-nodes, trigger-nodes, credentials, build, deploy, etc.)
get_doc(path)	Read a single doc page as markdown. Accepts slug, URL, or partial name.
search_docs(query, max_results?)	Regex search across all cached docs. Case-insensitive.
refresh()	Re-fetch all docs from GitHub tarball and overwrite cache.

Workflow Templates (live API)

Tool	Description
search_templates(query, max_results?)	Search n8n.io workflow templates by keyword. Returns template IDs, names, node lists.
get_template(id)	Fetch full workflow JSON (nodes, parameters, connections) for a template.

Workflow

Agent: "Slack에 메시지 보내는 워크플로우 만들어"
  1. search_templates("slack message")     → 비슷한 템플릿 발견
  2. get_template(1105)                     → 전체 노드 구성/파라미터 확인
  3. get_doc("n8n-nodes-base.slack")       → Slack 노드 사용법 참조
  4. 두 정보 결합 → 새 워크플로우 JSON 생성

Setup

The doc cache lives at ~/.cache/docs-n8n-mcp/ and auto-populates on first run (~1,500 files, ~5s via tarball). Cache refreshes automatically after 7 days. Template tools call the n8n.io API live (no cache needed).

cd /home/okdk/docs-n8n-mcp
uv run python fetcher.py   # manual cache population

OpenCode MCP registration

Registered in ~/.config/opencode/opencode.json as docs-n8n.