Skip to main content
The n8n-MCP server provides 20 specialized tools organized into 5 categories to help AI agents discover, configure, validate, and manage n8n workflows.

​
Tool Categories

​
Discovery Tools

Find and explore n8n nodes and templates.

search_nodes

Search 800+ n8n nodes by keyword with fuzzy matching

search_templates

Search 2,700+ workflow templates with multiple search modes

​
Configuration Tools

Get detailed node information and configuration schemas.

get_node

Get node schema with progressive detail levels (minimal, standard, full)

get_template

Retrieve complete workflow template by ID

​
Validation Tools

Validate nodes and workflows before deployment.

validate_node

Validate individual node configurations with multiple profiles

validate_workflow

Comprehensive workflow validation (structure, connections, expressions)

​
Workflow Management Tools

Create, update, and manage n8n workflows via API.

n8n_create_workflow

Create new workflows in n8n

n8n_get_workflow

Retrieve existing workflows with detail levels

n8n_update_partial_workflow

Update workflows using operation diffs (80-90% token savings)

n8n_update_full_workflow

Replace entire workflow

n8n_list_workflows

List workflows with filtering and pagination

n8n_delete_workflow

Delete workflows by ID

n8n_validate_workflow

Validate workflow in n8n before execution

n8n_autofix_workflow

Automatically fix common workflow issues

n8n_test_workflow

Execute workflow test runs

n8n_deploy_template

Deploy template directly to n8n

n8n_executions

Query workflow execution history

n8n_workflow_versions

Manage workflow version history

​
System Tools

Health checks, diagnostics, and tool documentation.

tools_documentation

Get documentation for MCP tools

n8n_health_check

Check n8n API connectivity

n8n_diagnostic

Run comprehensive system diagnostics

n8n_list_available_tools

List all available MCP tools with status
For AI agents building n8n workflows, follow this pattern:
  1. Discovery: Use search_nodes to find required nodes
  2. Configuration: Use get_node with detail="standard" to get node schemas
  3. Validation: Use validate_node to check configurations
  4. Assembly: Build workflow JSON with nodes and connections
  5. Pre-Deploy Check: Use validate_workflow to catch errors
  6. Deployment: Use n8n_create_workflow to deploy
  7. Testing: Use n8n_test_workflow to execute test runs

​
Tool Annotations

All tools include these annotations:
  • readOnlyHint: true for read-only operations
  • idempotentHint: true for operations that can be safely retried
  • destructiveHint: true for operations that delete data
  • openWorldHint: true for operations that interact with external systems (n8n API)

​
Performance Characteristics

  • Fast (< 50ms): search_nodes, get_node (minimal/standard), search_templates
  • Moderate (50-200ms): validate_node, get_template
  • Slower (200-500ms): validate_workflow, get_node (full), workflow management tools

​
Next Steps

Discovery Tools

Start with search_nodes to find the right nodes

Quick Start Guide

Build your first workflow with n8n-MCP

Build docs developers (and LLMs) love

Get started for freeTalk to us