n8n MCP Server

This is a Model Context Protocol (MCP) server that allows Large Language Models like Claude to interact with n8n via its REST API.

Features

The server provides tools for:

• Listing, retrieving, activating, and deactivating workflows
• Viewing workflow executions
• Getting credential type schemas

Prerequisites

• Node.js 16 or higher
• npm or yarn
• An n8n instance (self-hosted or cloud)
• n8n API key

Installation

1. Clone this repository
2. Install dependencies:

npm install

3. Create a .env file based on .env.example:

cp .env.example .env

4. Edit the .env file with your n8n host URL and API key:

N8N_HOST=http://your-n8n-instance:5678
N8N_API_KEY=your_n8n_api_key_here

5. Build the project:

npm run build

Running the server

Running locally

npm start

Running with Docker

1. Build and start the Docker container:

docker-compose up -d

2. To view logs:

docker-compose logs -f

3. To stop the server:

docker-compose down

Using with Claude Desktop

To configure Claude Desktop to use this server:

1. Open your Claude Desktop configuration file located at:

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

2. Add the following configuration:

{
  "mcpServers": {
    "n8n": {
      "command": "node",
      "args": [
        "/ABSOLUTE/PATH/TO/n8n-mcp-server/build/index.js"
      ],
      "env": {
        "N8N_HOST": "http://your-n8n-instance:5678",
        "N8N_API_KEY": "your_n8n_api_key_here"
      }
    }
  }
}

3. Save the file and restart Claude Desktop.

You can also use Docker to run the server:

{
  "mcpServers": {
    "n8n": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "N8N_HOST=http://your-n8n-instance:5678",
        "-e", "N8N_API_KEY=your_n8n_api_key_here",
        "n8n-mcp-server"
      ]
    }
  }
}

Available Tools

Workflows

• list-workflows: Get a list of workflows from n8n
• get-workflow: Get a specific workflow by ID
• activate-workflow: Activate a workflow
• deactivate-workflow: Deactivate a workflow

Executions

• list-executions: Get a list of workflow executions
• get-execution: Get a specific execution by ID

Credentials

• get-credential-type: Get credential type schema

Example Usage with Claude

Once connected to Claude Desktop, you can interact with n8n using natural language:

• "Show me all my n8n workflows"
• "Get details about the workflow with ID abc123"
• "Activate the workflow called 'Daily Report'"
• "Deactivate the workflow with ID xyz789"
• "Show me recent executions of my 'Data Import' workflow"
• "Get details for the execution with ID 12345"
• "What fields are required for the Notion credential type?"

Security Considerations

• This server requires your n8n API key, which provides full access to your n8n instance
• Store your API key securely and never share it
• Consider creating a limited-scope API key if your n8n instance supports it
• The server only implements read operations and limited state changes (activate/deactivate) to limit risk

Limitations

• This server only implements read operations for many resources to limit risk
• Some advanced n8n API features may not be implemented
• The server does not currently support executing workflows or creating new workflows

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT