n8n-workflow-builder

This MCP server connects AI assistants to your n8n workflow automation platform. It enables you to list, create, update, execute, and monitor n8n workflows directly from AI-assisted conversations. By configuring the MCP client (for example Claude Desktop) to talk to this server, you can issue natural language commands to search for workflows, generate new workflow definitions, trigger runs, and retrieve workflow status and outputs. The server uses the n8n API behind the scenes to perform actions, ensuring secure access through your n8n API key.

Prerequisites:

• Node.js v18+ installed on your machine
• Access to an n8n instance with a valid API key

Installation steps:

1. Install the MCP server package via NPX (recommended for quick start):

   • npx @makafeli/n8n-workflow-builder

2. If you prefer local development, clone and install:

   • git clone https://github.com/makafeli/n8n-workflow-builder.git
   • cd n8n-workflow-builder
   • npm install
   • npm run build (if a build step exists)
   • npm start

3. Set environment variables to connect to your n8n instance:

   • export N8N_HOST="http://localhost:5678"
   • export N8N_API_KEY="<your_n8n_api_key>"

4. Run the MCP server:

   • npx @makafeli/n8n-workflow-builder

Environment variables are required to connect to your n8n instance. Ensure your n8n API key has the necessary permissions for workflow management. If you deploy in a production environment, consider securing the API key and restricting access to the MCP client. The server is designed to work with MCP-compatible clients (e.g., Claude Desktop, ChatGPT integrations). If you encounter connectivity issues, verify N8N_HOST is reachable from the MCP host and that the API key is valid.