Skip to main content
n8n-MCP is a Model Context Protocol (MCP) server that gives AI assistants comprehensive access to n8n’s workflow automation platform. It serves as a bridge between AI models and n8n, enabling them to understand, build, and validate n8n workflows with deep knowledge of all 1,236 available nodes.

​
What is n8n-MCP?

n8n-MCP provides AI assistants like Claude with structured access to:

1,084 n8n nodes

537 core nodes + 547 community nodes (301 verified)

Node properties

99% coverage with detailed schemas and configurations

Node operations

63.6% coverage of available actions and parameters

Documentation

87% coverage from official n8n docs including AI nodes

AI tools

265 AI-capable tool variants with full documentation

Real-world examples

2,646 pre-extracted configurations from popular templates

Template library

2,709 workflow templates with 100% metadata coverage

Community nodes

Search verified community integrations with source filter

​
Why n8n-MCP exists

Building n8n workflows with AI used to be guesswork. AI assistants would try to remember node names, guess parameter formats, and hope configurations worked. One wrong parameter could break a workflow at 3 AM. n8n-MCP solves this by providing AI with:
  • Accurate node information - No more guessing if it’s scheduleTrigger or schedule
  • Real configuration examples - See how nodes are actually used in production workflows
  • Validation before deployment - Catch errors before they cause problems
  • Complete property schemas - Know exactly what parameters are required
  • Documentation access - Get official docs and AI-generated summaries

​
How it works

The Model Context Protocol (MCP) is a standard protocol that connects AI assistants to external data sources. n8n-MCP implements this protocol to serve as a knowledge server about n8n. When you ask Claude to build a workflow, it can:
  1. Search for nodes - Find the right nodes for your task with search_nodes
  2. Get node details - Retrieve properties, operations, and examples with get_node
  3. Validate configurations - Check if node configs are correct with validate_node
  4. Access templates - Find pre-built workflows with search_templates
  5. Validate workflows - Ensure complete workflows are production-ready with validate_workflow
For AI assistants: n8n-MCP provides 20 MCP tools for node discovery, validation, and workflow management. Start by calling tools_documentation() to learn how to use each tool effectively.

​
Key features

Find nodes by name, category, or functionality with full-text search: 
search_nodes({
  query: "send email gmail",
  includeExamples: true  // Get real-world configurations
})

​
Essential properties

Get only the properties that matter, filtered down to the 10-20 essential parameters: 
get_node({
  nodeType: "n8n-nodes-base.httpRequest",
  detail: "standard",
  includeExamples: true
})

​
Configuration validation

Validate node configurations before deployment with multiple strictness levels: 
validate_node({
  nodeType: "n8n-nodes-base.slack",
  config: { resource: "message", operation: "post" },
  mode: "full",
  profile: "runtime"
})

​
Real-world examples

2,646 pre-extracted configurations from popular workflow templates show you how nodes are actually used: 
{
  "resource": "message",
  "operation": "post",
  "select": "channel",
  "channelId": "C123ABC",
  "text": "Hello from n8n!"
}

​
Template discovery

Search through 2,709 workflow templates by keyword, nodes, task, or metadata: 
search_templates({
  searchMode: "by_task",
  task: "webhook_processing"
})

​
AI workflow validation

Comprehensive validation for AI Agent workflows including:
  • Missing language model detection
  • AI tool connection validation
  • Streaming mode constraints
  • Memory and output parser checks

​
Use cases

​
For developers

  • Build workflows faster - No more hunting through documentation
  • Catch errors early - Validate before deployment
  • Learn by example - See real configurations from popular templates
  • Explore nodes - Discover nodes you didn’t know existed

​
For AI assistants

  • Accurate information - Stop guessing node names and parameters
  • Context-efficient - Get only essential properties, not 100KB JSON dumps
  • Validation confidence - Verify configurations before suggesting them
  • Template awareness - Recommend proven workflow patterns

​
For teams

  • Consistent workflows - Everyone builds with validated configurations
  • Knowledge sharing - Templates and examples from the community
  • Faster onboarding - New team members learn from real examples
  • Production-ready - Multi-level validation catches issues early

​
Deployment options

You can use n8n-MCP in three ways:

Hosted service

Free tier with 100 tool calls/day, instant access, always up-to-date

Local setup

Run with npx or Docker on your machine for full control

Self-hosted

Deploy to Railway, Hetzner, or your own infrastructure
Important safety warning: Never edit production workflows directly with AI. Always make a copy, test in development, export backups, and validate changes before deploying to production.

​
What’s next?

Ready to get started? Choose your path:

Quick start

Get n8n-MCP running in under 5 minutes

Installation guide

Detailed setup for all deployment methods

Build docs developers (and LLMs) love

Get started for freeTalk to us