n8n-mcp: AI-Driven n8n Workflow Automation via MCP Server
n8n-mcp: AI-Driven n8n Workflow Automation via MCP Server
n8n-mcp acts as an MCP Server, providing AI assistants like Claude Desktop with comprehensive, structured access to n8n's workflow automation capabilities. This TypeScript-based server bridges the gap between AI models and n8n, enabling AI to design, build, and validate n8n workflows by leveraging detailed node documentation, properties, and operations.
Wiring n8n-mcp into Claude Desktop
Integrating n8n-mcp with Claude Desktop allows AI models to tap directly into n8n's extensive node ecosystem. The server can be run directly via npx, requiring only Node.js to be installed. Once running, Claude Desktop can be configured to use n8n-mcp as an MCP server.
For basic access, providing documentation tools only, the configuration is straightforward:
{
"mcpServers": {
"n8n-mcp": {
"command": "npx",
"args": ["n8n-mcp"],
"env": {
"MCP_MODE": "stdio",
"LOG_LEVEL": "error",
"DISABLE_CONSOLE_OUTPUT": "true"
}
}
}
}To unlock n8n management tools, including the ability to interact with an n8n instance, additional environment variables for the n8n API URL and key are required:
{
"mcpServers": {
"n8n-mcp": {
"command": "npx",
"args": ["n8n-mcp"],
"env": {
"MCP_MODE": "stdio",
"LOG_LEVEL": "error",
"DISABLE_CONSOLE_OUTPUT": "true",
"N8N_API_URL": "https://your-n8n-instance.com",
"N8N_API_KEY": "your-api-key"
}
}
}
}This setup enables Claude Desktop to utilize n8n-mcp's exposed tools for intelligent n8n workflow creation.
Deep n8n Knowledge for AI Models
n8n-mcp provides AI models with a granular understanding of n8n's architecture and capabilities. It offers structured access to over 525 n8n nodes from n8n-nodes-base and @n8n/n8n-nodes-langchain, including approximately 99% coverage of node properties with detailed schemas for accurate configuration. Furthermore, it covers about 63.6% of available node operations and 90% of official n8n documentation, including AI-specific nodes. The server also identifies over 263 AI-capable nodes, allowing AI to incorporate them into generated workflows.
Key Tools and Capabilities
The n8n-mcp server exposes several core tools designed to facilitate AI-driven n8n workflow creation:
tools_documentation: Provides documentation for any MCP tool, serving as an initial entry point for AI.list_nodes: Lists all n8n nodes, supporting filtering options for targeted searches.get_node_info: Retrieves comprehensive details about a specific n8n node.- Smart Node Search: Enables finding nodes by name, category, or functionality.
- Essential Properties: Focuses on the most critical 10-20 properties for efficient configuration.
- Task Templates: Offers pre-configured settings for common automation tasks.
- Config Validation: Validates node configurations before deployment to prevent errors.
- Dependency Analysis: Helps understand property relationships and conditions within nodes.
- Working Examples: Provides real-world examples for immediate practical application.
- Fast Response: Achieves an average query time of ~12ms, optimized with SQLite.
- Universal Compatibility: Works across any Node.js version.
These tools collectively empower AI assistants to not only understand n8n but to actively participate in the design and validation of complex automation workflows.