README

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-credential`	POST	Create a new credential
`delete-n8n-credential`	DELETE	Delete a credential
`move-n8n-credential`	PUT	Transfer a credential to a different project

User (5 tools)

Tool	Method	Description
`list-n8n-users`	GET	List all users
`get-n8n-user`	GET	Get a user by ID or email
`create-n8n-user`	POST	Invite one or more users
`change-n8n-user-role`	PATCH	Change a user's global role
`delete-n8n-user`	DELETE	Delete a user

Project (7 tools)

Tool	Method	Description
`list-n8n-projects`	GET	List all projects
`create-n8n-project`	POST	Create a new project
`update-n8n-project`	PUT	Rename a project
`delete-n8n-project`	DELETE	Delete a project
`add-n8n-project-users`	POST	Add users to a project with roles
`change-n8n-project-user-role`	PATCH	Change a user's role within a project
`remove-n8n-project-user`	DELETE	Remove a user from a project

Variable (6 tools)

Tool	Method	Description
`list-n8n-variables`	GET	List all environment variables
`create-n8n-variable`	POST	Create a single variable
`create-many-n8n-variables`	POST	Create multiple variables in one call
`update-n8n-variable`	PUT	Update an existing variable
`delete-n8n-variable`	DELETE	Delete a single variable
`delete-many-n8n-variables`	DELETE	Delete multiple variables by ID array

Tag (7 tools)

Tool	Method	Description
`list-n8n-tags`	GET	List all tags
`get-n8n-tag`	GET	Get a single tag by ID
`create-n8n-tag`	POST	Create a single tag
`create-many-n8n-tags`	POST	Create multiple tags in one call
`update-n8n-tag`	PUT	Rename a tag
`delete-n8n-tag`	DELETE	Delete a single tag
`delete-many-n8n-tags`	DELETE	Delete multiple tags by ID array

Source Control (1 tool)

Tool	Method	Description
`pull-n8n-source-control`	POST	Pull from the connected Git source control repository

Security / Audit (1 tool)

Tool	Method	Description
`generate-n8n-security-audit`	POST	Run a security audit and return diagnostics by category

Webhook (1 tool)

Tool	Method	Description
`trigger-n8n-webhook`	POST	Trigger an n8n workflow via its webhook path (sync or async)

Package Structure

src/
├── N8nMcpServiceProvider.php       # Auto-discovered, registers the MCP route
├── Server/
│   └── N8nServer.php               # MCP server definition with all 54 tools
└── Tools/
    ├── Workflow/       (14 tools)
    ├── WorkflowTag/    (2 tools)
    ├── Execution/      (4 tools)
    ├── Credential/     (6 tools)
    ├── User/           (5 tools)
    ├── Project/        (7 tools)
    ├── Variable/       (6 tools)
    ├── Tag/            (7 tools)
    ├── SourceControl/  (1 tool)
    ├── Security/       (1 tool)
    └── Webhook/        (1 tool)

config/
└── n8n-mcp.php                     # Route prefix and middleware config

How It Works

Each tool:

Validates its input parameters using Laravel's Validator
Calls the corresponding method on the N8nClient facade from kayedspace/laravel-n8n
Catches N8nException (and subclasses like ExecutionFailedException) and returns Response::error()
Returns Response::structured() on success

The kayedspace/laravel-n8n package handles retries, timeouts, caching, event dispatching, and HTTP client configuration via your .env settings.

Middleware / Authentication

By default the route uses the web middleware group. To restrict MCP access:

// config/n8n-mcp.php
'route_middleware' => ['web', 'auth:sanctum'],

License

MIT — see LICENSE.

rajurayhan / laravel-n8n-mcp-server

Maintainers

Package info

Statistics

Security