n8n MCP Server

A Model Context Protocol (MCP) server that enables seamless management of n8n workflows directly within LLMs and AI agents through the Smithery Model Context Protocol.

Features

- List available workflows from n8n
- View workflow details
- Execute workflows
- Monitor workflow executions
- Pass parameters to workflows
- MCP-compatible interface for AI agents

Getting Started

Quick Start

1. Install the package

   npm install @dopehunter/n8n-mcp-server

   

2. Create a .env file

   cp .env.example .env

   

3. Configure your n8n connection
Edit the .env file and set:
- N8N_BASE_URL: URL to your n8n instance (e.g., http://localhost:5678/api)
- N8N_API_KEY: Your n8n API key (generate this in n8n settings)

4. Start the server

   npm start

   

5. Test the server

   curl -X POST http://localhost:3000/mcp -H "Content-Type: application/json" \

     -d '{"jsonrpc":"2.0","id":"1","method":"mcp.tools.list","params":{}}'

   

Common Issues and Troubleshooting

- Connection Refused Errors: Make sure your n8n instance is running and accessible at the URL specified in N8N_BASE_URL
- API Key Issues: Verify your n8n API key is correct and has appropriate permissions
- Docker Issues: Ensure Docker is running before attempting to build or run the Docker image

For more detailed troubleshooting, see the Troubleshooting Guide.

Components

Tools

n8n_list_workflows
List all workflows in the n8n instance
Input: None

n8n_get_workflow
Get details of a specific workflow
Input: workflowId (string, required): ID of the workflow to retrieve

n8n_execute_workflow
Execute an n8n workflow
Inputs:
workflowId (string, required): ID of the workflow to execute
data (object, optional): Data to pass to the workflow

n8n_get_executions
Get execution history for a workflow
Inputs:
workflowId (string, required): ID of the workflow to get executions for
limit (number, optional): Maximum number of executions to return

n8n_activate_workflow
Activate a workflow
Input: workflowId (string, required): ID of the workflow to activate

n8n_deactivate_workflow
Deactivate a workflow
Input: workflowId (string, required): ID of the workflow to deactivate

Prerequisites

- Node.js (v14+)
- n8n instance with API access
- An LLM or AI agent that supports the Model Context Protocol

Configuration Options

Docker Configuration

{
  "mcpServers": {
    "n8n": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "--init", "-e", "N8N_API_KEY=$N8N_API_KEY", "-e", "N8N_BASE_URL=$N8N_BASE_URL", "mcp/n8n-mcp-server"]
    }
  }
}

NPX Configuration

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": ["-y", "@dopehunter/n8n-mcp-server"]
    }
  }
}

Installation

NPM

npm install @dopehunter/n8n-mcp-server

Direct Usage with npx

npx @dopehunter/n8n-mcp-server

From Source