mcp-n8n

n8n workflow automation API as a Python library, LangChain tools, and MCP server. Manage workflows, executions, credentials, tags, users, and webhooks from code or an MCP-compatible client.

Features

25 tools across 5 categories:

• Workflows (10) -- list, get, create, update, delete, activate, deactivate, execute, list active, get activation errors

• Executions (5) -- list, get, delete, retry, stop

• Credentials (4) -- list, get schema, create, delete

• Tags (3) -- list, create, delete

• Misc (3) -- list users, trigger webhook, check status

Installation

# Core library only
pip install .

# With MCP server
pip install ".[mcp]"

# With LangChain tools
pip install ".[langchain]"

# Everything
pip install ".[all]"

Configuration

Create a .env file:

N8N_API_KEY=your-n8n-api-key
N8N_HOST=localhost:5678
N8N_PROTOCOL=http

Quick Start

MCP Server

mcp-n8n

LangChain Tools

from mcp_n8n.langchain_tools import TOOLS, n8n_list_workflows

# Use individual tools
result = n8n_list_workflows.invoke({})

# Or pass all tools to an agent
from langchain.agents import AgentExecutor
agent = AgentExecutor(tools=TOOLS, ...)

Python Library

from mcp_n8n.client import N8nClient

client = N8nClient()
workflows = client.get_sync("/workflows")

License

MIT