mcp/n8n repository overview

⁠n8n MCP Server

Bridges n8n's workflow automation platform with AI models, providing access to 543 n8n nodes, workflow templates, and AI-capable automation tools.

What is an MCP Server?⁠

⁠MCP Info

⁠Image Building Info

Attribute	Details
Dockerfile	https://github.com/czlonkowski/n8n-mcp/blob/1bbfaabbc20f4989d81bc8a2cfc9f16795134ed8/Dockerfile⁠
Commit	1bbfaabbc20f4989d81bc8a2cfc9f16795134ed8
Docker Image built by	Docker Inc.
Docker Scout Health Score
Verify Signature	COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/n8n --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub
Licence	MIT License

⁠Available Tools (42)

⁠Tools Details

⁠Tool: get_database_statistics

Node stats: 525 total, 263 AI tools, 104 triggers, 87% docs coverage. Verifies MCP working.

⁠Tool: get_node_as_tool_info

How to use ANY node as AI tool. Shows requirements, use cases, examples. Works for all nodes, not just AI-marked ones.

⁠Tool: get_node_documentation

Get readable docs with examples/auth/patterns. Better than raw schema! 87% coverage. Format: "nodes-base.slack"

⁠Tool: get_node_essentials

Get node essential info with optional real-world examples from templates. Pass nodeType as string with prefix. Example: nodeType="nodes-base.slack". Use includeExamples=true to get top 3 template configs.

⁠Tool: get_node_info

Get full node documentation. Pass nodeType as string with prefix. Example: nodeType="nodes-base.webhook"

⁠Tool: get_property_dependencies

Shows property dependencies and visibility rules. Example: sendBody=true reveals body fields. Test visibility with optional config.

⁠Tool: get_template

Get template by ID. Use mode to control response size: nodes_only (minimal), structure (nodes+connections), full (complete workflow).

⁠Tool: get_templates_for_task

Curated templates by task. Returns paginated results sorted by popularity.

⁠Tool: list_ai_tools

List 263 AI-optimized nodes. Note: ANY node can be AI tool! Connect any node to AI Agent's tool port. Community nodes need N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true.

⁠Tool: list_node_templates

Find templates using specific nodes. Returns paginated results. Use FULL types: "n8n-nodes-base.httpRequest".

⁠Tool: list_nodes

List n8n nodes. Common: list_nodes({limit:200}) for all, list_nodes({category:'trigger'}) for triggers. Package: "n8n-nodes-base" or "@n8n/n8n-nodes-langchain". Categories: trigger/transform/output/input.

⁠Tool: list_tasks

List task templates by category: HTTP/API, Webhooks, Database, AI, Data Processing, Communication.

⁠Tool: list_templates

List all templates with minimal data (id, name, description, views, node count). Optionally include AI-generated metadata for smart filtering.

⁠Tool: n8n_autofix_workflow

Automatically fix common workflow validation errors. Preview fixes or apply them. Fixes expression format, typeVersion, error output config, webhook paths.

⁠Tool: n8n_create_workflow

Create workflow. Requires: name, nodes[], connections{}. Created inactive. Returns workflow with ID.

⁠Tool: n8n_delete_execution

Delete an execution record. This only removes the execution history, not any data processed.

⁠Tool: n8n_delete_workflow

Permanently delete a workflow. This action cannot be undone.

⁠Tool: n8n_diagnostic

Diagnose n8n API config. Shows tool status, API connectivity, env vars. Helps troubleshoot missing tools.

⁠Tool: n8n_get_execution

Get execution details with smart filtering. RECOMMENDED: Use mode='preview' first to assess data size. Examples:

• {id, mode:'preview'} - Structure & counts (fast, no data)
• {id, mode:'summary'} - 2 samples per node (default)
• {id, mode:'filtered', itemsLimit:5} - 5 items per node
• {id, nodeNames:['HTTP Request']} - Specific node only
• {id, mode:'full'} - Complete data (use with caution) Parameters|Type|Description -|-|- id|string|Execution ID includeData|boolean optional|Legacy: Include execution data. Maps to mode=summary if true (deprecated, use mode instead) includeInputData|boolean optional|Include input data in addition to output (default: false) itemsLimit|number optional|Items per node: 0=structure only, 2=default, -1=unlimited (for filtered mode) mode|string optional|Data retrieval mode: preview=structure only, summary=2 items, filtered=custom, full=all data nodeNames|array optional|Filter to specific nodes by name (for filtered mode)

⁠Tool: n8n_get_workflow

Get a workflow by ID. Returns the complete workflow including nodes, connections, and settings.

⁠Tool: n8n_get_workflow_details

Get workflow details with metadata, version, execution stats. More info than get_workflow.

⁠Tool: n8n_get_workflow_minimal

Get minimal info: ID, name, active status, tags. Fast for listings.

⁠Tool: n8n_get_workflow_structure

Get workflow structure: nodes and connections only. No parameter details.

⁠Tool: n8n_health_check

Check n8n instance health and API connectivity. Returns status and available features.

⁠Tool: n8n_list_available_tools

List available n8n tools and capabilities.

⁠Tool: n8n_list_executions

List workflow executions (returns up to limit). Check hasMore/nextCursor for pagination.

⁠Tool: n8n_list_workflows

List workflows (minimal metadata only). Returns id/name/active/dates/tags. Check hasMore/nextCursor for pagination.

⁠Tool: n8n_trigger_webhook_workflow

Trigger workflow via webhook. Must be ACTIVE with Webhook node. Method must match config.

⁠Tool: n8n_update_full_workflow

Full workflow update. Requires complete nodes[] and connections{}. For incremental use n8n_update_partial_workflow.

⁠Tool: n8n_update_partial_workflow

Update workflow incrementally with diff operations. Types: addNode, removeNode, updateNode, moveNode, enable/disableNode, addConnection, removeConnection, updateSettings, updateName, add/removeTag. See tools_documentation("n8n_update_partial_workflow", "full") for details.

⁠Tool: n8n_validate_workflow

Validate workflow by ID. Checks nodes, connections, expressions. Returns errors/warnings/suggestions.

⁠Tool: n8n_workflow_versions

Manage workflow version history, rollback, and cleanup. Six modes:

• list: Show version history for a workflow
• get: Get details of specific version
• rollback: Restore workflow to previous version (creates backup first)
• delete: Delete specific version or all versions for a workflow
• prune: Manually trigger pruning to keep N most recent versions
• truncate: Delete ALL versions for ALL workflows (requires confirmation) Parameters|Type|Description -|-|- mode|string|Operation mode confirmTruncate|boolean optional|REQUIRED: Must be true to truncate all versions (truncate mode only) deleteAll|boolean optional|Delete all versions for workflow (delete mode only) limit|number optional|Max versions to return in list mode maxVersions|number optional|Keep N most recent versions (prune mode only) validateBefore|boolean optional|Validate workflow structure before rollback versionId|number optional|Version ID (required for get mode and single version delete, optional for rollback) workflowId|string optional|Workflow ID (required for list, rollback, delete, prune)

⁠Tool: search_node_properties

Find specific properties in a node (auth, headers, body, etc). Returns paths and descriptions.

⁠Tool: search_nodes

Search n8n nodes by keyword with optional real-world examples. Pass query as string. Example: query="webhook" or query="database". Returns max 20 results. Use includeExamples=true to get top 2 template configs per node.

⁠Tool: search_templates

Search templates by name/description keywords. Returns paginated results. NOT for node types! For nodes use list_node_templates.

⁠Tool: search_templates_by_metadata

Search templates by AI-generated metadata. Filter by category, complexity, setup time, services, or audience. Returns rich metadata for smart template discovery.

⁠Tool: tools_documentation

Get documentation for n8n MCP tools. Call without parameters for quick start guide. Use topic parameter to get documentation for specific tools. Use depth='full' for comprehensive documentation.

⁠Tool: validate_node_minimal

Check n8n node required fields. Pass nodeType as string and config as empty object {}. Example: nodeType="nodes-base.webhook", config={}

⁠Tool: validate_node_operation

Validate n8n node configuration. Pass nodeType as string and config as object. Example: nodeType="nodes-base.slack", config={resource:"channel",operation:"create"}

⁠Tool: validate_workflow

Full workflow validation: structure, connections, expressions, AI tools. Returns errors/warnings/fixes. Essential before deploy.

⁠Tool: validate_workflow_connections

Check workflow connections only: valid nodes, no cycles, proper triggers, AI tool links. Fast structure validation.

⁠Tool: validate_workflow_expressions

Validate n8n expressions: syntax {{}}, variables ($json/$node), references. Returns errors with locations.

⁠Use this MCP Server

{
  "mcpServers": {
    "n8n": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "N8N_API_URL",
        "-e",
        "N8N_API_KEY",
        "mcp/n8n"
      ],
      "env": {
        "N8N_API_URL": "http://host.docker.internal:5678",
        "N8N_API_KEY": "n8n_api_****"
      }
    }
  }
}

Why is it safer to run MCP Servers with Docker?⁠