n8n-mcp-server
MCP ServerFreeMCP server that provides tools and resources for interacting with n8n API
Capabilities12 decomposed
mcp-native workflow crud operations with structured tool definitions
Medium confidenceExposes n8n workflow lifecycle management (create, read, update, delete) through the Model Context Protocol's tool system, using JSON schema-based tool definitions that allow AI assistants to invoke workflow operations with type-safe parameters. Each operation maps directly to n8n REST API endpoints (POST /workflows, GET /workflows/{id}, etc.) with automatic parameter validation and error handling at the MCP layer.
Implements MCP tool definitions for n8n CRUD operations with automatic schema generation from n8n API responses, enabling AI assistants to understand workflow structure without hardcoded tool definitions. Uses a layered architecture where the Tools System abstracts n8n REST API details, allowing the MCP server to handle parameter marshaling and response transformation transparently.
More AI-native than direct n8n API calls because it uses MCP's structured tool protocol, making LLMs understand workflow operations as first-class capabilities rather than generic HTTP requests; stronger than simple REST wrappers because it includes schema validation and error context at the MCP layer.
dual-mode workflow execution via api and webhook triggers
Medium confidenceProvides two distinct execution pathways for n8n workflows: direct API execution (execution_run tool) that triggers workflows synchronously through the n8n REST API, and webhook execution (run_webhook tool) that invokes workflows via HTTP webhook endpoints with optional basic authentication. The server abstracts both mechanisms through a unified tool interface, allowing AI assistants to choose execution mode based on workflow requirements (synchronous vs. asynchronous, authenticated vs. public).
Abstracts two fundamentally different execution mechanisms (REST API vs. HTTP webhooks) behind a unified MCP tool interface, allowing AI assistants to select execution mode without understanding underlying transport differences. Implements basic auth marshaling for webhook calls, handling credential injection transparently rather than exposing raw HTTP details to the LLM.
More flexible than n8n's native API alone because it supports both synchronous and asynchronous execution patterns; more secure than direct webhook URLs because it centralizes credential management in the MCP server rather than exposing URLs to the LLM.
workflow retrieval with full configuration inspection
Medium confidenceProvides a tool to fetch complete workflow definitions (workflow_get) by workflow ID, returning the full configuration including all nodes, connections, credentials, and metadata. This allows AI assistants to inspect existing workflows, understand their structure, and use that information for modification or cloning. The tool returns the exact workflow definition that would be used for updates or exports.
Exposes complete workflow definitions through a tool interface, allowing AI assistants to inspect and reason about workflow structure. Returns the exact configuration format used for updates, enabling round-trip modification (fetch → modify → update) without schema translation.
More detailed than workflow metadata because it includes full node and connection configuration; stronger than the workflow list because it provides actionable data for modification, not just summary information.
workflow listing with metadata summary
Medium confidenceProvides a tool to list all workflows in the n8n instance (workflow_list) with summary metadata including workflow ID, name, active status, creation date, and last update time. This allows AI assistants to discover available workflows, understand the workflow inventory, and select specific workflows for further operations. The list is returned as an array of workflow summary objects.
Provides a simple workflow discovery tool that returns summary metadata, allowing AI assistants to understand the workflow inventory without fetching full definitions. Integrates with the Resources System to also expose workflow lists as static resources (n8n://workflows/list).
More efficient than fetching full workflow definitions because it returns only summary metadata; stronger than manual UI browsing because it's programmatic and can be used by AI agents for decision-making.
execution monitoring and lifecycle control with status polling
Medium confidenceProvides tools to query execution status (execution_get, execution_list), stop running executions (execution_stop), and retrieve execution statistics through the Resources System. The implementation polls the n8n API for execution state, allowing AI assistants to monitor workflow progress, detect failures, and make decisions based on execution outcomes without requiring webhooks or event subscriptions.
Implements a polling-based execution monitoring system that allows AI assistants to synchronously wait for asynchronous workflow completion, bridging the gap between LLM request-response semantics and n8n's event-driven execution model. Uses the Resources System to expose execution statistics as queryable data, enabling agents to make decisions based on historical execution patterns.
More AI-friendly than raw n8n API polling because it abstracts retry logic and error handling; stronger than webhook-only approaches because it supports both push (webhooks) and pull (polling) patterns, giving agents flexibility in how they monitor workflows.
static and dynamic resource exposure via mcp resource protocol
Medium confidenceExposes n8n data as MCP resources (n8n://workflows/list, n8n://workflow/{id}, n8n://execution-stats, etc.), allowing AI assistants to retrieve structured information about workflows and executions as readable resources rather than tool outputs. Static resources (workflow list, health status) are fetched on-demand, while dynamic resources support parameterized queries (e.g., n8n://workflow/123 returns details for workflow 123). This enables AI assistants to reference n8n data in their context window without explicit tool invocations.
Implements the MCP resource protocol to expose n8n data as first-class resources rather than tool outputs, allowing AI assistants to reference workflow information in their reasoning without explicit function calls. Supports both static resources (fixed paths) and dynamic resources (parameterized by ID), providing a flexible data access model that integrates with MCP clients' context management.
More context-efficient than tool-based data retrieval because resources can be embedded in system prompts or referenced without tool invocation overhead; stronger than simple API wrappers because it uses MCP's native resource protocol, enabling better integration with Claude and other MCP-aware assistants.
environment-driven configuration with multi-instance support
Medium confidenceManages n8n connection configuration through environment variables (N8N_API_URL, N8N_API_KEY, N8N_WEBHOOK_USERNAME, N8N_WEBHOOK_PASSWORD), allowing the MCP server to connect to different n8n instances by changing environment variables. The configuration is loaded at server startup and used to initialize API clients, supporting both local and remote n8n instances with optional webhook authentication. This enables deployment flexibility without code changes.
Uses environment-driven configuration to decouple n8n connection details from code, enabling the same MCP server binary to connect to different n8n instances. Supports optional webhook authentication credentials, allowing the server to invoke secured webhook endpoints without exposing credentials to AI assistants.
More flexible than hardcoded configuration because it supports environment-based deployment patterns; more secure than embedding credentials in code because it uses standard environment variable practices, compatible with Docker, Kubernetes, and other containerized deployment systems.
layered error handling and debug logging with context preservation
Medium confidenceImplements error handling at multiple layers (MCP protocol layer, n8n API layer, transport layer) with optional debug logging controlled by the DEBUG environment variable. Errors from n8n API calls are caught, transformed into MCP-compatible error responses, and logged with context (request parameters, API response status). This allows AI assistants to understand why operations failed and enables developers to diagnose issues through server logs.
Implements multi-layer error handling that catches failures at the MCP protocol level, n8n API level, and transport level, transforming them into consistent error responses. Uses optional debug logging to preserve context about failed operations, enabling both AI assistants and developers to understand failure reasons.
More diagnostic than silent failures because it provides detailed error context; stronger than generic error messages because it preserves request parameters and API responses, enabling root cause analysis without re-running failed operations.
workflow activation and deactivation state management
Medium confidenceProvides tools to activate (workflow_activate) and deactivate (workflow_deactivate) n8n workflows, controlling whether workflows respond to triggers. These operations toggle the workflow's active status through the n8n API, allowing AI assistants to enable/disable workflows without modifying their configuration. The state change is immediate and persisted in n8n's database.
Exposes workflow activation state as a controllable tool, allowing AI assistants to manage workflow availability without understanding n8n's internal state machine. Implements state changes as atomic API calls, ensuring consistency between the MCP server's view and n8n's actual state.
More user-friendly than manual n8n UI toggling because it's programmable; stronger than deletion because it preserves workflow configuration, allowing workflows to be re-enabled without reconfiguration.
workflow deletion with permanent removal
Medium confidenceProvides a tool to permanently delete workflows (workflow_delete) from the n8n instance through the REST API. This operation removes the workflow definition and all associated metadata, making it irreversible. The tool requires explicit workflow ID specification to prevent accidental deletions.
Implements workflow deletion as a direct MCP tool, allowing AI assistants to manage workflow lifecycle including removal. Requires explicit workflow ID to prevent accidental bulk deletions, providing a safety mechanism at the tool interface level.
More programmatic than manual deletion through the n8n UI; stronger than deactivation because it completely removes workflows, freeing resources and reducing clutter in the workflow list.
workflow update with configuration modification
Medium confidenceProvides a tool to update existing workflow definitions (workflow_update) by submitting modified workflow configuration objects to the n8n API. The tool accepts a workflow ID and a partial or complete workflow definition, merging changes with the existing configuration. This allows AI assistants to modify workflow nodes, connections, and settings without recreating the entire workflow.
Exposes workflow update as a tool that accepts complete workflow definition objects, allowing AI assistants to modify workflows programmatically. Abstracts n8n's workflow schema complexity behind a single tool interface, enabling LLMs to reason about workflow changes without understanding internal node structures.
More flexible than activation/deactivation because it allows arbitrary configuration changes; stronger than deletion + recreation because it preserves workflow history and execution records, maintaining continuity.
workflow creation with node-based configuration
Medium confidenceProvides a tool to create new workflows (workflow_create) by accepting a workflow definition object containing nodes, connections, and metadata. The tool submits the definition to the n8n API, which validates the structure and creates the workflow in the database. This allows AI assistants to generate complete workflows from scratch based on user requirements, including node configuration, data flow, and trigger setup.
Enables AI assistants to generate complete workflows by accepting workflow definition objects, allowing LLMs to reason about workflow structure and node configuration. Abstracts n8n's REST API behind a tool interface, enabling AI-driven workflow generation without exposing raw HTTP details.
More powerful than UI-based workflow creation because it's programmable and can generate complex multi-node workflows; stronger than simple API wrappers because it provides structured tool definitions that help LLMs understand workflow schema requirements.
Capabilities are decomposed by AI analysis. Each maps to specific user intents and improves with match feedback.
Related Artifactssharing capabilities
Artifacts that share capabilities with n8n-mcp-server, ranked by overlap. Discovered automatically through the match graph.
n8n-nodes-mcp
MCP nodes for n8n
n8n-mcp
Integration between n8n workflow automation and Model Context Protocol (MCP)
n8n-workflow-builder
AI assistant integration for n8n workflow automation through Model Context Protocol (MCP). Connect Claude Desktop, ChatGPT, and other AI assistants to n8n for natural language workflow management.
DifyWorkflow
** - Tools to the query and execute of Dify workflows
@voltagent/mcp-server
VoltAgent MCP server implementation for exposing agents, tools, and workflows via the Model Context Protocol.
@mcpilotx/intentorch
Intent-Driven MCP Orchestration Toolkit - Transform natural language into executable workflows with AI-powered intent parsing and MCP tool orchestration
Best For
- ✓AI agent developers building autonomous workflow management systems
- ✓Teams integrating n8n with Claude, ChatGPT, or other MCP-compatible LLMs
- ✓Non-technical users who want AI-mediated workflow creation without API knowledge
- ✓Developers building real-time AI agents that depend on workflow output
- ✓Teams with long-running workflows that should execute asynchronously
- ✓Organizations requiring webhook-based integrations with basic auth security
- ✓AI agents that need to understand workflow structure before modification
- ✓Developers building workflow analysis or migration tools
Known Limitations
- ⚠No built-in workflow validation before submission — relies on n8n API to reject invalid configurations
- ⚠Workflow complexity is limited by n8n's API payload size constraints (typically 1-10MB per workflow definition)
- ⚠No transactional guarantees — partial failures in multi-step workflow creation are not rolled back
- ⚠API execution is synchronous only — no built-in timeout handling for long-running workflows (may block MCP server)
- ⚠Webhook execution provides no built-in response polling — caller must implement their own status checking
- ⚠Basic auth for webhooks is transmitted in HTTP headers — requires HTTPS in production to prevent credential exposure
Requirements
Input / Output
UnfragileRank
UnfragileRank is computed from adoption signals, documentation quality, ecosystem connectivity, match graph feedback, and freshness. No artifact can pay for a higher rank.
Repository Details
Last commit: Jul 9, 2025
About
MCP server that provides tools and resources for interacting with n8n API
Categories
Alternatives to n8n-mcp-server
Are you the builder of n8n-mcp-server?
Claim this artifact to get a verified badge, access match analytics, see which intents users search for, and manage your listing.
Get the weekly brief
New tools, rising stars, and what's actually worth your time. No spam.
Data Sources
Looking for something else?
Search →