n8n MCP Server

A Model Context Protocol (MCP) server that allows AI assistants to interact with n8n workflows through natural language.

Overview

This project provides a Model Context Protocol (MCP) server that empowers AI assistants to seamlessly interact with n8n, a popular workflow automation tool. It acts as a bridge, enabling AI assistants to programmatically manage and control n8n workflows and executions using natural language commands.

Installation

Prerequisites

• Node.js 20 or later
• n8n instance with API access enabled

Install from npm

npm install -g @leonardsellem/n8n-mcp-server

Install from source

# Clone the repository
git clone https://github.com/leonardsellem/n8n-mcp-server.git
cd n8n-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

# Optional: Install globally
npm install -g .

Docker Installation

You can also run the server using Docker:

# Pull the image
docker pull leonardsellem/n8n-mcp-server

# Run the container with your n8n API configuration
docker run -e N8N_API_URL=http://your-n8n:5678/api/v1 \
  -e N8N_API_KEY=your_n8n_api_key \
  -e N8N_WEBHOOK_USERNAME=username \
  -e N8N_WEBHOOK_PASSWORD=password \
  leonardsellem/n8n-mcp-server

Updating the Server

How you update the server depends on how you initially installed it.

1. Installed globally via npm

If you installed the server using npm install -g @leonardsellem/n8n-mcp-server:

1. Open your terminal or command prompt.
2. Run the following command to get the latest version:

   npm install -g @leonardsellem/n8n-mcp-server@latest
   

3. If the server is currently running (e.g., as a background process or service), you'll need to restart it for the changes to take effect.

2. Installed from source

If you cloned the repository and installed from source:

1. Open your terminal or command prompt.
2. Navigate to the directory where you cloned the project:

   cd path/to/n8n-mcp-server
   

3. If you've made any local changes to the code that you want to keep, consider stashing them (optional):

   git stash
   

   You can apply them later with git stash pop.
4. Pull the latest changes from the repository (assuming you are on the main branch):

   git pull origin main
   

   If you are on a different branch, replace main with your branch name.
5. Install or update any changed dependencies:

   npm install
   

6. Rebuild the project to include the latest updates:

   npm run build
   

7. If you previously installed it globally from this source folder using npm install -g ., you might want to run this command again to update the global link:

   npm install -g .
   

8. Restart the server.
   • If you run the server directly using a command like node build/index.js in your AI assistant's MCP configuration, ensure the path is still correct. Using npm install -g . and then n8n-mcp-server as the command should keep this consistent.

3. Using Docker

If you are running the server using Docker:

1. Pull the latest image from Docker Hub:

   docker pull leonardsellem/n8n-mcp-server:latest
   

2. Stop and remove your old container. You'll need your container's name or ID (you can find it using docker ps):

   docker stop <your_container_name_or_id>
   docker rm <your_container_name_or_id>
   

3. Start a new container with the updated image. Use the same docker run command you used previously, including all your necessary environment variables (refer to the "Docker Installation" section for an example command). For instance:

   docker run -e N8N_API_URL=http://your-n8n:5678/api/v1 \
     -e N8N_API_KEY=your_n8n_api
   

... View full README on GitHub