n8n MCP Server

What is n8n MCP Server?

n8n MCP Server is a Model Context Protocol server that allows Large Language Models like Claude to interact with n8n via its REST API. It provides tools to manage workflows, view executions, and retrieve credential type schemas.

How to use n8n MCP Server?

Install dependencies with npm, configure a .env file with your n8n host URL and API key, then build and start the server. For integration with Claude Desktop, add a JSON configuration entry specifying the command (local node or Docker) and environment variables.

Key features of n8n MCP Server

• List, retrieve, activate, and deactivate n8n workflows
• View workflow executions and execution details
• Get credential type schema for credential management
• Run locally or via Docker container
• Integrate with Claude Desktop via MCP configuration

Use cases of n8n MCP Server

• Ask an LLM to show all n8n workflows in natural language
• Activate or deactivate workflows by name or ID through conversation
• Retrieve recent workflow executions and execution details
• Request credential type schemas for setup guidance (e.g., Notion)
• Manage n8n workflow state without manual UI navigation

FAQ from n8n MCP Server

What prerequisites are needed to use n8n MCP Server?

Node.js 16 or higher, npm or yarn, a running n8n instance (self-hosted or cloud), and an n8n API key.

How do I run n8n MCP Server with Docker?

Use docker-compose up -d to build and start the container, and docker-compose down to stop it. View logs with docker-compose logs -f.

How do I configure Claude Desktop to use n8n MCP Server?

Edit the Claude Desktop configuration file (claude_desktop_config.json) to add an mcpServers entry with the server command (node or Docker) and the required N8N_HOST and N8N_API_KEY environment variables.

What tools does n8n MCP Server provide?

It provides tools for workflows (list, get, activate, deactivate), executions (list, get), and credentials (get credential type). Currently it does not support executing or creating new workflows.

What security considerations should I be aware of?

The server requires your n8n API key, which provides full access to your n8n instance. Store credentials securely, consider using limited-scope API keys if supported, and note that the server only implements read operations plus activate/deactivate to limit risk.