N8N

MCP server implementation for n8n workflow automation

typescript

120

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "illuminaresolutions-n8n-mcp-server": {
      "command": "n8n-mcp-server",
      "args": [],
      "env": {
        "N8N_HOST": "https://your-n8n-instance.com",
        "N8N_API_KEY": "your-api-key-here"
      }
    }
  }
}

This MCP server provides secure, standardized access to your n8n workflows, executions, credentials, and related data so you can control and automate n8n from language models and other MCP clients.

How to use

To use the n8n MCP server, connect your MCP client to the local server and perform actions such as listing workflows, retrieving details, executing workflows, and managing credentials. Start by configuring the server in your MCP client so it runs as a local or remote endpoint, then issue high-level actions like listing workflows, running a workflow, or inspecting credentials. Ensure your n8n instance is reachable and that your API key has the required permissions.

How to install

Prerequisites: You need Node.js and npm installed on your system.

Option 1: Install from npm (recommended)

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

Option 2: Install from source

Clone the repository, install dependencies, build, and start the server in the background.

git clone https://github.com/illuminaresolutions/n8n-mcp-server.git
cd n8n-mcp-server
npm install
npm run build
nohup npm start > n8n-mcp.log 2>&1 &

To stop the server, run:

pkill -f "node build/index.js"

Additional configuration and usage notes

The server is configured to connect to your n8n instance using an API key. Two common configuration methods are available for different environments.

Available tools

List workflows

Retrieve and display the workflows available in your n8n instance.

View workflow details

Fetch and show detailed information about a specific workflow, including nodes and triggers.

Execute workflow

Run a selected workflow and monitor its execution results.

Manage credentials

Create, view, update, or delete credentials used by workflows.

Handle tags

Add, remove, or search workflow tags for organization and discovery.

Generate security audits

Produce an audit report covering access and activity related to workflows and credentials.