n8n Workflow Builder MCP Server
by salacoste
This project provides an MCP (Model Context Protocol) server for managing n8n workflows. It allows you to create, update, delete, activate, and deactivate workflows through tools available in Claude AI and Cursor IDE.
Last updated: N/A
What is n8n Workflow Builder MCP Server?
The n8n Workflow Builder MCP Server is a tool that enables users to manage n8n workflows programmatically through the Model Context Protocol (MCP). It provides an interface for creating, updating, deleting, activating, and deactivating n8n workflows, primarily designed for integration with AI tools like Claude and Cursor IDE.
How to use n8n Workflow Builder MCP Server?
To use the server, you need to install it via npm or clone the repository, configure environment variables (N8N_HOST, N8N_API_KEY), and run the server. Integration with Claude App requires creating a cline_mcp_settings.json file. The server exposes MCP tools accessible via stdio or JSON-RPC, allowing you to manage workflows and executions. Test scripts are provided to verify functionality.
Key features of n8n Workflow Builder MCP Server
Full integration with Claude AI and Cursor IDE via MCP protocol
Create and manage n8n workflows via natural language
Predefined workflow templates through prompts system
Interactive workflow building with real-time feedback
Use cases of n8n Workflow Builder MCP Server
Automating n8n workflow management through AI assistants
Building and deploying n8n workflows programmatically
Integrating n8n with other applications via MCP
Creating custom workflow templates using the prompts system
FAQ from n8n Workflow Builder MCP Server
What n8n version is supported?
What n8n version is supported?
The server is tested and compatible with n8n version 1.82.3.
What are the requirements for running the server?
What are the requirements for running the server?
You need Node.js (v14+), npm, an n8n instance with API access, and Claude App or Cursor IDE for AI interaction.
How do I integrate with Claude App?
How do I integrate with Claude App?
Create a cline_mcp_settings.json file with the correct environment variable values and configure Claude to use the MCP server.
What if I encounter a port conflict?
What if I encounter a port conflict?
Specify a custom port using the MCP_PORT environment variable or find and kill the process using the port. Starting with version 0.7.2, the server handles port conflicts gracefully.
Why can't I activate a workflow without a trigger?
Why can't I activate a workflow without a trigger?
n8n requires at least one valid trigger node to activate a workflow. The activate_workflow tool automatically adds a scheduleTrigger node if none is detected.