PHPackages                             jpcaparas/laravel-n8n-client - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. jpcaparas/laravel-n8n-client

ActiveLibrary[API Development](/categories/api)

jpcaparas/laravel-n8n-client
============================

A Laravel library that interfaces with the self-hosted n8n.io REST API

v0.1.0(1y ago)141.3k4MITPHPPHP ^8.1

Since Jan 7Pushed 1y ago1 watchersCompare

[ Source](https://github.com/jpcaparas/laravel-n8n-client)[ Packagist](https://packagist.org/packages/jpcaparas/laravel-n8n-client)[ RSS](/packages/jpcaparas-laravel-n8n-client/feed)WikiDiscussions main Synced 3w ago

READMEChangelogDependencies (4)Versions (2)Used By (0)

jpcaparas/laravel-n8n-client
============================

[](#jpcaparaslaravel-n8n-client)

[![Tests](https://github.com/jpcaparas/laravel-n8n-client/actions/workflows/tests.yml/badge.svg)](https://github.com/jpcaparas/laravel-n8n-client/actions/workflows/tests.yml/badge.svg)

A Laravel library that interfaces with the [self-hosted n8n](https://docs.n8n.io/hosting/community-edition-features/) [REST API](https://docs.n8n.io/api/api-reference/).

[![SCR-20250107-rpsu](https://private-user-images.githubusercontent.com/2406808/400671540-2744c287-d977-4da1-a2a7-53740e10c5cb.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODIzODY2NTIsIm5iZiI6MTc4MjM4NjM1MiwicGF0aCI6Ii8yNDA2ODA4LzQwMDY3MTU0MC0yNzQ0YzI4Ny1kOTc3LTRkYTEtYTJhNy01Mzc0MGUxMGM1Y2IucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI2MDYyNSUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNjA2MjVUMTExOTEyWiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9MWRiNGExYjk3MTZmOGQ2MzRiNmY0ZWRjODdlNmZlOWE2OWIwNjY0NjNjODBhZTkxNDhhODlkYWQwN2JhYjhkOSZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmcmVzcG9uc2UtY29udGVudC10eXBlPWltYWdlJTJGcG5nIn0.VhHkauAV8Xd3DjqBDHBLpv74TcRFaKN2UWxA121wfQA)](https://private-user-images.githubusercontent.com/2406808/400671540-2744c287-d977-4da1-a2a7-53740e10c5cb.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODIzODY2NTIsIm5iZiI6MTc4MjM4NjM1MiwicGF0aCI6Ii8yNDA2ODA4LzQwMDY3MTU0MC0yNzQ0YzI4Ny1kOTc3LTRkYTEtYTJhNy01Mzc0MGUxMGM1Y2IucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI2MDYyNSUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNjA2MjVUMTExOTEyWiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9MWRiNGExYjk3MTZmOGQ2MzRiNmY0ZWRjODdlNmZlOWE2OWIwNjY0NjNjODBhZTkxNDhhODlkYWQwN2JhYjhkOSZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmcmVzcG9uc2UtY29udGVudC10eXBlPWltYWdlJTJGcG5nIn0.VhHkauAV8Xd3DjqBDHBLpv74TcRFaKN2UWxA121wfQA)Installation
------------

[](#installation)

You can install the package via Composer:

```
composer require jpcaparas/laravel-n8n-client
```

Publish the configuration file:

```
php artisan vendor:publish --provider="JPCaparas\N8N\N8NServiceProvider" --tag="config"
```

Set these credentials inside your `.env` file:

```
N8N_BASE_URI=http://[your_n8n_instance]:[your_n8n_port]
N8N_API_TOKEN=[your_n8n_api_token]

```

Local testing
-------------

[](#local-testing)

If you want to interact with the package locally, you can use the Laravel skeleton provided by `orchestra/testbench` and its associated Tinker REPL:

1. Publish the configuration file to the Laravel skeleton.

```
composer test:publish
```

1. Modify `.env` API credentials on the skeleton as needed:

```
N8N_BASE_URI=http://localhost:5678
N8N_API_TOKEN=[your_n8n_api_token]
```

2. Enter the Tinker REPL:

```
composer test:tinker
```

2. Create an instance of the N8N client:

```
$n8n = app(\JPCaparas\N8N\N8NClient::class);
```

3. Make API requests using the N8N client:

```
$response = $n8n->get('valid-endpoint');
$response = $n8n->post('valid-endpoint', ['data' => 'value']);
```

There are also convenience methods for the most common API endpoints:

```
$response = $n8n->getWorkflows();
$response = $n8n->getWorkflow('workflow-id');
$response = $n8n->createWorkflow(['name' => 'New Workflow']);
$response = $n8n->updateWorkflow('workflow-id', ['name' => 'Updated Workflow']);
```

Tests
-----

[](#tests)

```
composer test
```

License
-------

[](#license)

MIT

###  Health Score

30

—

LowBetter than 62% of packages

Maintenance38

Infrequent updates — may be unmaintained

Popularity28

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity37

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

536d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/2406808?v=4)[JP Caparas](/maintainers/jpcaparas)[@jpcaparas](https://github.com/jpcaparas)

---

Top Contributors

[![jpcaparas](https://avatars.githubusercontent.com/u/2406808?v=4)](https://github.com/jpcaparas "jpcaparas (12 commits)")

---

Tags

agentic-aiailaraveln8nphp

###  Code Quality

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/jpcaparas-laravel-n8n-client/health.svg)

```
[![Health](https://phpackages.com/badges/jpcaparas-laravel-n8n-client/health.svg)](https://phpackages.com/packages/jpcaparas-laravel-n8n-client)
```

###  Alternatives

[statamic/cms

The Statamic CMS Core Package

4.8k3.5M920](/packages/statamic-cms)[backpack/crud

Quickly build admin interfaces using Laravel, Bootstrap and JavaScript.

3.4k3.6M217](/packages/backpack-crud)[unopim/unopim

UnoPim Laravel PIM

10.3k2.2k](/packages/unopim-unopim)[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3661.2M46](/packages/tencentcloud-tencentcloud-sdk-php)[mozex/anthropic-laravel

Laravel integration for the Anthropic API: facade, config publishing, install command, testing fakes, messages, streaming, tool use, thinking, and batches.

72287.1k1](/packages/mozex-anthropic-laravel)[justbetter/laravel-magento-client

A client to interact with Magento

49108.7k14](/packages/justbetter-laravel-magento-client)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)