Skip to main content
Glama
SohailShabbir867

n8n Automation MCP Server

⚡ n8n Automation MCP Server

Enterprise-Grade Model Context Protocol (MCP) Server for Complete n8n Instance Automation

npm version MCP SDK n8n API TypeScript License: MIT


n8n Automation MCP Server turns Large Language Models (LLMs) in Claude Desktop, Cursor AI, Windsurf, and VS Code into full-stack n8n automation engineers.

With 34 production-ready tools, this MCP server empowers AI agents to autonomously build workflows, debug failed executions, manage credentials, configure environment variables, manage tags, and monitor self-hosted or cloud n8n instances in real time.


🎯 High-Rank Keywords & SEO Overview

Keywords: n8n MCP server, n8n REST API automation, Model Context Protocol, Claude Desktop n8n tool, Cursor AI n8n workflow builder, n8n execution debugger, AI workflow orchestrator, self-hosted n8n management, n8n credential manager, n8n workflow export import.


Related MCP server: n8n Workflow Builder

✨ Key Features

Feature

Description

🤖 34 Dedicated MCP Tools

Complete coverage of the n8n REST API v1 for Workflows, Executions, Credentials, Tags, Variables, and Users.

💡 Node Templates & Snippets

Built-in list_common_nodes provides instant JSON templates for OpenAI, Slack, Webhooks, Schedules, Code, HTTP Requests, and Switch nodes.

📦 Export & Import Workflows

Backup, share, or version-control workflows seamlessly between local and cloud n8n instances.

⚡ Execution Diagnostics & Retries

Filter error logs, inspect node input/output payloads, stop stuck runs, or trigger single-click execution retries (retry_execution).

🔒 Enterprise Security & Clean Logs

Sensitive credential payloads are automatically masked in responses. Zero unhandled server crashes on startup.

🚀 Lightning-Fast Builds

Built with esbuild for instant compilation (<100ms) with zero TypeScript memory leaks.


📐 Architecture

flowchart LR
    subgraph AI Clients
        A[Claude Desktop]
        B[Cursor AI]
        C[Windsurf / VS Code]
    end

    subgraph MCP Protocol
        D[n8n Automation MCP Server]
    end

    subgraph n8n Ecosystem
        E[(n8n Self-Hosted / Cloud)]
        F[Workflows Engine]
        G[Executions Log]
        H[Credentials Store]
        I[Instance Variables]
    end

    A <-->|stdio Transport| D
    B <-->|stdio Transport| D
    C <-->|stdio Transport| D

    D <-->|n8n v1 REST API / X-N8N-API-KEY| E
    E --> F
    E --> G
    E --> H
    E --> I

🚀 Quick Start

1. Prerequisites

  • Node.js: v18.0.0 or higher

  • n8n Instance: Self-hosted (http://localhost:5678) or n8n Cloud (https://your-instance.app.n8n.cloud)

  • n8n API Key: Get it from n8n > Settings > API > Create API Key

2. Clone & Install

git clone https://github.com/SohailShabbir867/n8n_mcp.git
cd n8n_mcp
npm install

3. Environment Setup

Create a .env file in the project root:

N8N_BASE_URL=http://localhost:5678
N8N_API_KEY=your_n8n_api_key_here

4. Build

npm run build

💻 Claude Desktop & Cursor Setup

⚙️ Claude Desktop Configuration

Add the server entry to your %APPDATA%\Claude\claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "n8n-automation": {
      "command": "node",
      "args": ["C:/path/to/n8n_mcp/dist/index.js"],
      "env": {
        "N8N_BASE_URL": "http://localhost:5678",
        "N8N_API_KEY": "your_n8n_api_key_here"
      }
    }
  }
}

⚡ Cursor / Windsurf Configuration

Navigate to Cursor Settings > Features > MCP Servers and click Add New MCP Server:

  • Name: n8n-automation

  • Type: command

  • Command: node C:/path/to/n8n_mcp/dist/index.js


🛠️ Tool Reference (34 Complete Tools)

📦 Workflows (11 Tools)

Tool Name

Description

Key Parameters

list_workflows

List workflows with filtering by status, name, tags

active, tags, name, limit

get_workflow

Get node graph, connections, and settings by ID

id

create_workflow

Create a new workflow graph with nodes

name, nodes, connections, settings, activate

update_workflow

Update workflow graph, nodes, tags, or settings

id, name, nodes, connections, active

delete_workflow

Permanently delete a workflow

id

activate_workflow

Enable auto-trigger execution

id

deactivate_workflow

Pause auto-trigger execution

id

duplicate_workflow

Create an exact copy of a workflow

id, name

export_workflow

Export workflow as formatted JSON structure

id

import_workflow

Import workflow graph from JSON definition

workflowJson, activate

list_common_nodes

Get JSON templates for Webhook, OpenAI, Slack, etc.

category

⚡ Executions (6 Tools)

Tool Name

Description

Key Parameters

list_executions

Search execution logs by status & workflow ID

workflowId, status, limit

get_execution

Inspect node-by-node payload inputs & outputs

id, includeData

delete_execution

Remove an execution record

id

run_workflow

Manually trigger execution with payload

id, data

retry_execution

Retry a failed execution run

id, loadWorkflowFromDb

stop_execution

Stop or cancel an active running execution

id

🔑 Credentials (6 Tools)

Tool Name

Description

Key Parameters

list_credentials

List saved auth credential metadata

name, limit

get_credential

Inspect credential type & dates (secrets masked)

id

create_credential

Save a new credential object

name, type, data

update_credential

Update name, type, or data of a credential

id, name, type, data

delete_credential

Delete a saved credential

id

list_credential_types

Search available credential types (openAiApi, etc.)

search

🌐 Instance Variables (4 Tools)

Tool Name

Description

Key Parameters

list_variables

List custom environment variables

limit

create_variable

Create a key-value instance variable

key, value

update_variable

Update variable key or value

id, key, value

delete_variable

Delete an environment variable

id

🏷️ Tags (4 Tools)

Tool Name

Description

Key Parameters

list_tags

List all workflow tags

limit

create_tag

Create a new tag

name

update_tag

Rename an existing tag

id, name

delete_tag

Delete a tag

id

🛡️ System & Users (3 Tools)

Tool Name

Description

Key Parameters

test_connection

Test connection latency & API authentication

None

list_users

List registered n8n users

limit

get_user

View user profile details by ID

id


💡 Example AI Prompts

Try asking Claude or Cursor AI these automation tasks:

"Test connection to my n8n server and report API latency."
"Create an active workflow named 'Daily AI Summary' with a Schedule Trigger running at 9am and an OpenAI node."
"Find all failed executions from today, inspect node errors, and retry the failed run."
"Export workflow ID 'wK82x9L' to a JSON string so I can save it."
"Create an n8n variable named 'ENVIRONMENT' with value 'production'."

🔍 Troubleshooting & FAQ


🤝 Contributing

Contributions, feature suggestions, and pull requests are warmly welcome!

  1. Fork the Project

  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)

  3. Commit your Changes (git commit -m 'Add some AmazingFeature')

  4. Push to the Branch (git push origin feature/AmazingFeature)

  5. Open a Pull Request


📜 License

Distributed under the MIT License. See LICENSE for more information.


Made with ❤️ by Sohail Shabbir

Star this repository if you find it helpful!

Install Server
F
license - not found
-
quality - not tested
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • -
    license
    -
    quality
    -
    maintenance
    Provides seamless integration between MCP-compatible AI assistants and n8n workflow automation, enabling intelligent management and automation of n8n workflows through natural language.
    5
  • A
    license
    -
    quality
    D
    maintenance
    Provides AI assistants with direct access to the n8n automation platform to manage and execute workflows, variables, and credentials. It features 18 integrated tools that allow for seamless automation management via the Model Context Protocol.
    159
    3
    MIT
  • A
    license
    B
    quality
    D
    maintenance
    A comprehensive MCP server that provides full control over n8n automation workflows through natural language. It offers 43 tools for managing workflows, executions, credentials, and data tables, with safety features like write-mode protection and double-validated workflow creation.
    43
    1
    MIT

View all related MCP servers

Related MCP Connectors

  • Free public MCP for AI agents — 193 tools, 44 workflows. No API key.

  • Create, browse, remix, collaborate on, and run durable AI workflow nodes from MCP hosts.

  • Self-hosted MCP gateway: turn any API, database or MCP server into AI connectors — no code.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/SohailShabbir867/n8n_mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server