n8n MCP Server

A Model Context Protocol (MCP) server enabling AI assistants to interact with n8n workflows using natural language.

Overview

This MCP server offers tools for AI assistants to manage n8n workflows and executions, including listing, creating, updating, and deleting workflows. It also allows for activating/deactivating workflows, executing them, monitoring their status, and accessing workflow information and execution statistics.

Installation

Requires Node.js 18+ and an n8n instance with API access. Installation is possible via npm (npm install -g n8n-mcp-server) or from source, involving cloning the repository, installing dependencies (npm install), and building the project (npm run build).

Configuration

Configuration involves creating a .env file based on .env.example and setting environment variables like N8N_API_URL, N8N_API_KEY, N8N_WEBHOOK_USERNAME, and N8N_WEBHOOK_PASSWORD. The N8N_API_KEY can be generated within the n8n settings.

Usage

The server is run using n8n-mcp-server. Integration with AI assistants requires registering the server with the assistant platform, potentially using the MCP installer.

Resources

Provides resources like n8n://workflows/list for workflow lists and n8n://workflow/{id} for workflow details.

Development

Includes commands for building (npm run build), running in development mode (npm run dev), testing (npm test), and linting (npm run lint).

License

MIT