n8n-mcp-server

What is n8n-mcp-server?

A Model-Controller-Provider (MCP) server implementation for n8n workflow automation. It provides a standardized JSON-RPC 2.0 interface for executing and managing n8n workflows.

How to use n8n-mcp-server?

Clone the repository, install dependencies (npm install), and configure required environment variables (N8N_URL, N8N_API_KEY, N8N_API_HEADER). Start the server with npm start or use Docker (docker build -t n8n-mcp-server && docker run -p 3000:3000 --env-file .env n8n-mcp-server).

Key features of n8n-mcp-server

• JSON-RPC 2.0 compliant API
• Workflow execution and management
• Environment-based configuration
• TypeScript support
• Comprehensive logging
• Docker support

Use cases of n8n-mcp-server

• Execute n8n workflows programmatically via JSON-RPC
• Manage workflow tools from MCP clients
• Automate n8n operations in a standardized way
• Integrate workflow automation into external applications

FAQ from n8n-mcp-server

What are the prerequisites for using n8n-mcp-server?

Node.js >= 14.0.0, a running n8n instance, and an n8n API key.

What environment variables are required to configure the server?

N8N_URL (n8n instance API URL), N8N_API_KEY (your API key), and N8N_API_HEADER (header name, default: X-N8N-API-KEY).

How can I start the server?

Use npm start for standard mode, npm run start:dev for development with hot reload, npm run start:simple for minimal features, or npm run debug for debug mode.

Does n8n-mcp-server support Docker?

Yes. You can build and run with docker build -t n8n-mcp-server . and docker run -p 3000:3000 --env-file .env n8n-mcp-server, or use docker-compose up.

What JSON-RPC methods does the server implement?

It provides initialize, shutdown, listTools, and callTool methods. See API.md for details.