n8n

n8n

MCP server enabling AI assistants to manage n8n workflows via natural language.

1,472
Stars
265
Forks
0
Releases

Overview

n8n MCP Server is a Model Context Protocol (MCP) server that enables AI assistants to seamlessly interact with n8n, a popular workflow automation tool. It acts as a bridge between conversational AI and the n8n API, translating natural language commands into programmatic actions for managing workflows and their executions. The server exposes a suite of MCP tools for workflow lifecycle operations (list, get, create, update, delete, activate, deactivate) and for execution control (run, stop, list, get), plus webhook-triggered runs via the run_webhook tool. It supports configuring access to your n8n instance through environment variables such as N8N_API_URL, N8N_API_KEY, and optional N8N_WEBHOOK_USERNAME and N8N_WEBHOOK_PASSWORD for webhook authentication. It defines convenient resource endpoints such as n8n://workflows/list, n8n://workflow/{id}, n8n://executions/{workflowId}, and n8n://execution/{id} to reference items in prompts. The README also shows how to integrate with AI assistants (e.g., VS Code with Claude extension or Claude Desktop) by pointing to the built file, and outlines deployment options including npm install, building from source, or Docker. It remains community-driven with opportunities to contribute as co-maintainers.

Details

Owner
leonardsellem
Language
TypeScript
License
MIT License
Updated
2025-12-07

Features

Natural language bridge between AI and n8n

Enables AI assistants to control n8n workflows through natural language prompts, bridging conversational AI with the n8n API.

Workflow management tools

Workflow lifecycle operations: list, get, create, update, delete, activate, deactivate workflows.

Execution management tools

Execution controls: run, stop, list, get executions for workflows.

Webhook-based execution

Run workflows via webhooks using the run_webhook tool, with optional webhook authentication.

Authentication and security

Configurable with N8N_API_URL, N8N_API_KEY, and optional N8N_WEBHOOK_USERNAME/N8N_WEBHOOK_PASSWORD.

Resource endpoint mappings

Provided endpoints such as n8n://workflows/list, n8n://workflow/{id}, n8n://executions/{workflowId}, and n8n://execution/{id} for reference in prompts.

AI assistant integration ready

Guidance and examples for integrating with AI assistants (e.g., VS Code, Claude) and running the built server file.

Flexible deployment options

Supports npm installation, building from source, or Docker deployment for different environments.

Audience

AI assistantsInteract with and control n8n workflows via natural language commands.
DevelopersIntegrate AI-enabled workflow management into apps and assistants via MCP server.

Tags

n8nMCPModel Context ProtocolAIworkflowsautomationwebhookAPIintegrationdeployment