Laravel QuickBooks MCP

A first-party PHP/Laravel Composer package that exposes QuickBooks Online (QBO) as a Model Context Protocol (MCP) server. AI clients — Claude, Cursor, n8n, and others — connect over HTTP and perform full CRUD operations on QBO entities using natural language.

This is the first PHP/Laravel QuickBooks MCP implementation in the ecosystem.

---

Features

• 50 MCP tools covering 11 QBO entities (customers, vendors, invoices, bills, estimates, purchases, employees, items, accounts, journal entries, and bill payments)
• Remote HTTP transport — not local stdio, so it works with any hosted AI client
• Multi-tenant — multiple QBO companies per Laravel installation
• Name-to-ID resolution — agents pass human-readable names; ID lookups happen automatically
• Full OAuth 2.0 flow — any SaaS user can connect their own QBO company
• Production-ready from day one (sandbox also supported)
• Laravel-native auth — works with Passport or Sanctum, no assumptions made

---

Requirements

Your host application must also have:

• A users table with an id column (standard Laravel)
• The HasQuickBooksToken trait from spinen/laravel-quickbooks-client on the User model
• At least one configured auth guard that resolves auth()->user() from a Bearer token (Passport or Sanctum)

---

Installation

1. Install via Composer

composer require rajurayhan/laravel-quickbooks-mcp-server

2. Publish package assets

# Publish config
php artisan vendor:publish --tag=quickbooks-mcp-config

# Publish migrations
php artisan vendor:publish --tag=quickbooks-mcp-migrations

# Publish routes stub
php artisan vendor:publish --tag=quickbooks-mcp-routes

# Or publish everything at once
php artisan vendor:publish --provider="Raju\QuickBooksMcp\QuickBooksMcpServiceProvider"

3. Run migrations

php artisan migrate

This creates one table: quickbooks_connections.

4. Configure your .env

# Intuit app credentials (from developer.intuit.com)
QUICKBOOKS_CLIENT_ID=your_intuit_app_client_id
QUICKBOOKS_CLIENT_SECRET=your_intuit_app_client_secret
QUICKBOOKS_REDIRECT_URI=https://yourdomain.com/quickbooks/callback
QUICKBOOKS_SCOPE=com.intuit.quickbooks.accounting
QUICKBOOKS_DATA_SOURCE=production   # or: development (sandbox)

# MCP server settings
QBO_MCP_PATH=mcp/quickbooks
QBO_TOKEN_REFRESH_BUFFER=5

5. Register the published routes

Open routes/quickbooks-mcp.php (published to your app’s routes/ folder) and register it in your application. Choose one of:

Option A — in app/Providers/AppServiceProvider.php:

public function boot(): void
{
    Route::middleware('web')
        ->group(base_path('routes/quickbooks-mcp.php'));
}