n8n MCP Server

What is n8n MCP Server?

The n8n MCP Server is a Model Context Protocol server that enables management of n8n workflows directly within LLMs and AI agents. It provides an MCP-compatible interface for listing, viewing, executing, and monitoring n8n workflows.

How to use n8n MCP Server?

Install the package via npm install @dopehunter/n8n-mcp-server, configure a .env file with N8N_BASE_URL and N8N_API_KEY, then start the server with npm start. Alternatively, run it via npx @dopehunter/n8n-mcp-server or using Docker. Connect your LLM client (e.g., Claude Desktop) to the server URL.

Key features of n8n MCP Server

• List all workflows in the n8n instance
• View details of a specific workflow
• Execute workflows with optional data parameters
• Monitor workflow execution history
• Activate and deactivate workflows
• MCP-compatible interface for AI agents

Use cases of n8n MCP Server

• AI agents triggering n8n workflows via natural language commands
• Querying workflow status and execution logs from an LLM
• Passing dynamic data to workflows from conversational interfaces
• Automating workflow activation or deactivation through AI

FAQ from n8n MCP Server

What are the prerequisites for using n8n MCP Server?

Node.js v14+, a running n8n instance with API access, and an LLM or AI agent that supports the Model Context Protocol.

How do I configure the connection to my n8n instance?

Set the N8N_BASE_URL (e.g., http://localhost:5678/api) and N8N_API_KEY environment variables in a .env file.

What tools does n8n MCP Server provide?

It includes n8n_list_workflows, n8n_get_workflow, n8n_execute_workflow, n8n_get_executions, n8n_activate_workflow, and n8n_deactivate_workflow.

How can I run the server using Docker?

Use the Docker configuration: docker run -i --rm --init -e N8N_API_KEY=... -e N8N_BASE_URL=... mcp/n8n-mcp-server.

What should I do if I get a connection refused error?

Ensure your n8n instance is running and accessible at the URL specified in N8N_BASE_URL.