n8n-mcp

Searches across 1,396 n8n nodes (812 core + 584 community) using a pre-built SQLite database with full-text search indexes, returning node metadata, parameter schemas, and usage examples without requiring external API calls. The system builds the index at compile-time by parsing n8n npm packages, then serves read-only queries at runtime via MCP protocol, enabling sub-100ms lookups for node discovery and documentation retrieval.

Searches a database of 2,709 n8n templates using semantic similarity and keyword matching to find relevant workflow templates for a user's intent. The system ranks templates by relevance using a similarity service that compares user queries against template metadata (name, description, tags, use cases), returning ranked results with template structure, node composition, and deployment instructions.

Manages 2,709 workflow templates by extracting and indexing metadata (name, description, tags, use cases, node composition), enabling template discovery, pattern analysis, and reuse. The system analyzes template structure to identify common patterns, node combinations, and best practices, making this information available for workflow generation and learning.

Automatically corrects common workflow configuration errors by analyzing validation failures and generating corrected parameter values and credential bindings. The system uses heuristics and pattern matching to suggest fixes for missing credentials, invalid parameter types, and malformed expressions, enabling AI assistants to self-correct generated workflows.

Supports multi-tenant deployments through environment-based configuration, enabling different n8n instances, API credentials, and database backends to be configured per deployment. The system reads configuration from environment variables, supporting Docker, Railway, and HTTP server deployments with isolated tenant contexts.

Suggests appropriate parameter values for workflow nodes based on node type, parameter schema, and context from upstream nodes. The system infers parameter types from node definitions, validates suggested values against schema constraints, and provides intelligent suggestions that account for data flow through the workflow.

Collects telemetry data on workflow execution, tool usage, and performance metrics, enabling analysis of workflow patterns, performance bottlenecks, and usage trends. The system tracks execution times, error rates, and tool call patterns, providing insights into workflow behavior and system performance.

Validates n8n workflow configurations against multiple validation profiles (strict, lenient, custom) before deployment, checking for missing credentials, invalid parameter types, disconnected nodes, and expression syntax errors. The system uses specialized validators (src/services/workflow-validator.ts) that analyze workflow JSON structure and provide actionable auto-fix suggestions, including parameter corrections and credential binding recommendations, without requiring workflow execution.

Validates n8n's custom expression language (JavaScript-like syntax with special functions like $json, $env, $now) by parsing expressions against a grammar and checking for syntax errors, undefined variable references, and type mismatches. The system identifies invalid expressions in workflow parameters before deployment, providing line-by-line error reporting with suggestions for correction.

Analyzes differences between two workflow versions (original and modified) by comparing node configurations, connections, and parameters, then assesses the impact of changes on workflow behavior. The system identifies added/removed/modified nodes, changed parameter values, and altered connections, providing a structured diff report that helps users understand what changed and why.

Provides a typed API client (src/services/n8n-api-client.ts) that communicates with n8n instances via REST API, handling authentication, credential management, and workflow lifecycle operations (create, read, update, delete, execute). The client abstracts n8n API complexity, providing high-level methods for common operations while managing session state and error handling.

Scans workflow configurations for security vulnerabilities including hardcoded credentials, exposed secrets in expressions, insecure parameter values, and suspicious node combinations. The system analyzes workflow JSON and expressions using pattern matching and heuristics to identify potential security risks before deployment, providing remediation recommendations.

Implements the Model Context Protocol (MCP) server with support for both stdio transport (for local Claude Desktop integration) and HTTP transport (for remote/SaaS deployments). The server negotiates protocol versions, routes tool calls to appropriate handlers, and manages session state across different transport mechanisms, enabling the same tool set to work in multiple deployment scenarios.

Separates tools into two tiers: documentation tools that work standalone with the local SQLite database (node search, template discovery, validation), and management tools that require external n8n API access (workflow CRUD, credential management, execution). This separation enables offline documentation access while maintaining clear boundaries for operations that require API credentials.

Manages 584 community nodes alongside 812 core nodes, with version detection and compatibility checking to ensure workflows use compatible node versions. The system tracks node versions, detects breaking changes between versions, and provides compatibility warnings when workflows reference nodes that may not be available in the target n8n instance.