n8n MCP Server

This is a Model Context Protocol (MCP) server that allows AI assistants to interact with n8n workflows through natural language.

API Endpoint

🔑 Required HTTP Headers

For MCP authentication:

x-api-key

Your server authentication key (contact us for access)

For n8n access:

x-n8n-api-key

Your n8n API key (generate in n8n Settings → API → API Keys)

x-n8n-api-url

Your n8n instance URL (e.g., https://n8n.majewscy.tech/api/v1)

Optional webhook credentials:

x-webhook-username

x-webhook-password

🧪 Test Your Connection

1. List Available Tools

curl -X POST https://n8n.mcp.majewscy.tech/ \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_SERVER_KEY" \
  -H "x-n8n-api-key: YOUR_N8N_KEY" \
  -H "x-n8n-api-url: https://n8n.majewscy.tech/api/v1" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/list",
    "id": 1
  }'

2. List Your Workflows

curl -X POST https://n8n.mcp.majewscy.tech/ \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_SERVER_KEY" \
  -H "x-n8n-api-key: YOUR_N8N_KEY" \
  -H "x-n8n-api-url: https://n8n.majewscy.tech/api/v1" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "workflow_list",
      "arguments": {}
    },
    "id": 2
  }'

🔧 Configuration Examples

Claude Code (.mcp.json)

{
  "mcpServers": {
    "n8n": {
      "type": "http",
      "url": "https://n8n.mcp.majewscy.tech/",
      "headers": {
        "x-api-key": "YOUR_SERVER_KEY",
        "x-n8n-api-key": "YOUR_N8N_KEY",
        "x-n8n-api-url": "https://n8n.majewscy.tech/api/v1"
      }
    }
  }
}

Available Tools

📊 Workflow Management

workflow_list - List all workflows
workflow_get - Get details of a specific workflow
workflow_create - Create a new workflow
workflow_update - Update an existing workflow
workflow_delete - Delete a workflow
workflow_activate - Activate a workflow
workflow_deactivate - Deactivate a workflow

⚡ Execution Management

execution_run - Execute a workflow via the API
run_webhook - Execute a workflow via a webhook
execution_get - Get details of a specific execution
execution_list - List executions for a workflow
execution_stop - Stop a running execution