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