n8n MCP Server

mcp-n8n

The most complete MCP server for [n8n](https://n8n.io)

43 tools · Workflows · Data Tables · Tags · Credentials · Users · Webhooks · Audit

Quick Start · All 43 Tools · Configuration · Contributing

---

Why mcp-n8n?

Other n8n MCPs cover workflows and executions. mcp-n8n covers everything — including Data Tables, the only MCP to do so.

Data Tables — full CRUD with filters, search, upsert and dry-run. No other MCP has this.

---

🚀 Quick Start

Claude Code

claude mcp add --scope user \

-e N8N_BASE_URL=http://localhost:5678 \ -e N8N_API_KEY=your-api-key \ -- n8n npx -y @nextoolsolutions/mcp-n8n

Cursor

Add to ~/.cursor/mcp.json:

{

"mcpServers": { "n8n": { "command": "npx", "args": ["-y", "mcp-n8n"], "env": { "N8N_BASE_URL": "http://localhost:5678", "N8N_API_KEY": "your-api-key" } } } }

Claude Desktop

Add to claude_desktop_config.json:

{

"mcpServers": { "n8n": { "command": "npx", "args": ["-y", "mcp-n8n"], "env": { "N8N_BASE_URL": "http://localhost:5678", "N8N_API_KEY": "your-api-key" } } } }

Config file location:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Windsurf

Add to your Windsurf MCP config:

{

"mcpServers": { "n8n": { "command": "npx", "args": ["-y", "mcp-n8n"], "env": { "N8N_BASE_URL": "http://localhost:5678", "N8N_API_KEY": "your-api-key" } } } }

VS Code (Copilot)

Add to your VS Code settings.json:

{

"mcp": { "servers": { "n8n": { "command": "npx", "args": ["-y", "mcp-n8n"], "env": { "N8N_BASE_URL": "http://localhost:5678", "N8N_API_KEY": "your-api-key" } } } } }

Getting your API key

1. Open your n8n instance
2. Go to Settings → n8n API
3. Create a new API key
4. Copy it into the N8N_API_KEY environment variable

---

🛠 Tools

Workflows (10)

Executions (3)

Data Tables (8)

Only available in n8n v1.64+. This is the only MCP server with Data Tables support.

Tags (5)

Credentials (4)

Users (3)

Variables (3)

Projects (4) — Enterprise

Audit (1)

System (1)

Webhooks (1)

---

⚙️ Configuration

---

✨ Features

• 43 tools — the most comprehensive n8n MCP available
• Data Tables — full CRUD, the only MCP with this support
• Automatic retry — exponential backoff on rate limits (429) and server errors (5xx)
• Configurable timeout — prevent hung requests (default 30s)
• Zero external dependencies — only MCP SDK + Zod
• TypeScript strict mode — fully typed, safe, and maintainable
• Node 16+ compatible — native fetch with http/https fallback

---

🔒 Security

• API keys are never hardcoded — loaded exclusively from environment variables
• Credential data is redacted in list responses (n8n API behavior)
• All IDs are sanitized with encodeURIComponent to prevent path traversal
• No sensitive data is logged or exposed in error messages

---

🏗 Development

git clone https://github.com/NexTools-Solutions/mcp-n8n.git

cd mcp-n8n npm install

Project structure

mcp-n8n/

├── src/ │ ├── index.ts # MCP server — tool registration and handlers │ └── n8n-client.ts # HTTP client — API calls, retry, timeout ├── dist/ # Compiled output ├── package.json ├── tsconfig.json └── README.md

---

🤝 Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch (git checkout -b feat/my-feature)
3. Commit your changes
4. Push and open a Pull Request

---

📄 License

MIT — free for personal and commercial use.

---

Built by NexTool Solutions

If this project helps you, consider giving it a ⭐