Laravel n8n MCP Server

A Laravel package that exposes the full n8n REST API and webhook capabilities as Model Context Protocol (MCP) tools — making every n8n action available to AI agents and coding assistants.

Built on top of kayedspace/laravel-n8n for the HTTP client layer and laravel/mcp for the MCP server infrastructure.

Requirements

• PHP 8.2+
• Laravel 11 or 12
• laravel/mcp >= 0.1.0
• kayedspace/laravel-n8n ^1.1

Installation

1. Require the package

composer require rajurayhan/laravel-n8n-mcp-server

This also installs kayedspace/laravel-n8n automatically as a dependency. The service provider is auto-discovered by Laravel — no manual registration needed.

2. Publish the config

php artisan vendor:publish --tag=n8n-mcp-config

4. Set environment variables

# n8n API connection (required)
N8N_API_BASE_URL=https://your-n8n-instance.com/api/v1
N8N_API_KEY=your_api_key

# n8n webhook base URL (required for TriggerWebhook tool)
N8N_WEBHOOK_BASE_URL=https://your-n8n-instance.com/webhook
N8N_WEBHOOK_USERNAME=your_webhook_username   # optional basic auth
N8N_WEBHOOK_PASSWORD=your_webhook_password   # optional basic auth

# MCP route (optional, defaults shown)
N8N_MCP_ROUTE_PREFIX=mcp/n8n

The MCP server will be available at https://yourapp.com/mcp/n8n.

Configuration

// config/n8n-mcp.php
return [
    'route_prefix'     => env('N8N_MCP_ROUTE_PREFIX', 'mcp/n8n'),
    'route_middleware' => ['web'],  // add 'auth:sanctum' to restrict access
];

Tools Reference

54 tools are registered across 11 resource groups. Every public method on every client class in kayedspace/laravel-n8n has a corresponding MCP tool.

Workflow (14 tools)

| Tool | Method | Description | |---|---|---| | list-n8n-workflows | GET | List workflows with optional filters (active, name, tags, projectId) | | get-n8n-workflow | GET | Get full workflow definition by ID | | search-n8n-workflows-by-webhook | GET | Find workflows containing a Webhook node matching a path | | create-n8n-workflow | POST | Create a new workflow | | update-n8n-workflow | PUT | Replace a workflow definition | | delete-n8n-workflow | DELETE | Delete a single workflow | | delete-many-n8n-workflows | DELETE | Delete multiple workflows by ID array | | activate-n8n-workflow | POST | Activate a single workflow | | activate-many-n8n-workflows | POST | Activate multiple workflows by ID array | | deactivate-n8n-workflow | POST | Deactivate a single workflow | | deactivate-many-n8n-workflows | POST | Deactivate multiple workflows by ID array | | move-n8n-workflow | PUT | Transfer a workflow to a different project | | export-n8n-workflows | GET | Export workflow definitions as JSON (backup/migration) | | import-n8n-workflows | POST | Import workflow definitions (IDs stripped, creates new) |

Workflow Tags (2 tools)

| Tool | Method | Description | |---|---|---| | list-n8n-workflow-tags | GET | List tags on a specific workflow | | update-n8n-workflow-tags | PUT | Replace the full tag set on a workflow |

Execution (4 tools)

| Tool | Method | Description | |---|---|---| | list-n8n-executions | GET | List executions with filters (status, workflowId, projectId) | | get-n8n-execution | GET | Get execution details by ID, optionally including node data | | wait-for-n8n-execution | GET | Poll an execution until it completes or times out | | delete-n8n-executions | DELETE | Delete one or more execution records |

Credential (6 tools)

| Tool | Method | Description | |---|---|---| | list-n8n-credentials | GET | List stored credentials | | get-n8n-credential | GET | Get a credential by ID | | get-n8n-credential-schema | GET | Get the JSON schema for a credential type (e.g. slackApi) | | `create-n8n-credenti

... View full README on GitHub