robrodriguezjr/n8n-mcp-server

n8n MCP Server

A Model Context Protocol (MCP) server for integrating with n8n workflow automation on your Synology NAS.

Overview

This MCP server allows Claude Code to interact with your n8n instance, enabling you to:

• List and manage workflows
• Activate/deactivate workflows
• Execute workflows with custom input data
• Monitor workflow executions
• Create simple workflows
• Get detailed workflow and execution information

Prerequisites

• Python 3.10 or higher
• n8n instance running on your Synology NAS
• Access to n8n API (either via API key or basic authentication)

Installation

1. Install dependencies:

   pip install mcp httpx pydantic
   

2. Make the server executable:

   chmod +x n8n_mcp_server.py
   

Configuration

Before using the tools, you need to configure the connection to your n8n instance using the configure_n8n_connection tool with your n8n details:

• base_url: Your n8n instance URL (e.g., http://your-nas-ip:5678)
• api_key: (Optional) API key for authentication
• username/password: (Optional) Basic authentication credentials

Available Tools

Connection Management

• configure_n8n_connection: Set up connection to your n8n instance

Workflow Management

• list_workflows: List all workflows (with optional active-only filter)
• get_workflow_details: Get detailed information about a specific workflow
• activate_workflow: Activate a workflow for automatic execution
• deactivate_workflow: Deactivate a workflow
• create_simple_workflow: Create a new workflow with manual trigger

Execution Management

• execute_workflow: Manually execute a workflow with optional input data
• get_executions: Get recent workflow executions
• get_execution_details: Get detailed information about a specific execution

Claude Desktop Configuration

Add this server to your Claude Desktop configuration file:

macOS

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "n8n-automation": {
      "command": "python",
      "args": ["/absolute/path/to/n8n_mcp_server.py"],
      "env": {}
    }
  }
}

Windows

Edit %APPDATA%/Claude/claude_desktop_config.json with similar configuration.

Usage Examples

1. Configure connection:

   Use the configure_n8n_connection tool with your n8n instance details
   

2. List all active workflows:

   Use list_workflows with active_only=true
   

3. Execute a workflow:

   Use execute_workflow with the workflow ID and any required input data
   

4. Monitor executions:

   Use get_executions to see recent workflow runs
   

Security Notes

• Keep your API keys and credentials secure
• The server only connects to your specified n8n instance
• All API calls are made over HTTP/HTTPS as configured
• No credentials are stored permanently by the server

Troubleshooting

• Ensure your n8n instance is accessible from where you run this server
• Check that your API key or credentials are correct
• Verify the base URL includes the protocol (http:// or https://)
• Check n8n logs for any API-related errors

Development

To run in development mode:

python n8n_mcp_server.py

The server uses stdio transport for communication with MCP clients.