MCP 服务器

Booqable MCP Server

This server allows AI assistants to interact directly with your Booqable rental management system, providing tools to manage inventory, orders, and more.

README

Booqable MCP Server

A Model Context Protocol (MCP) server for integrating with Booqable. This server allows AI assistants to interact directly with your Booqable rental management system, providing tools to manage inventory, orders, and more.

Built with TypeScript and leveraging the official Booqable API.

Available Modules & Tools

Inventory

Manage product groups and inventory items.

inventory_list: List product groups (inventory items). Optionally filter by name, SKU, type, or tracking mode. Includes photo URLs by default.
inventory_get: Fetch a single product group by UUID. Returns full details including photo URL by default.
inventory_search: Full-text search across product group names and SKUs. Returns matching items with photo URLs.

Orders

Manage rental orders and their contents.

orders_list: List orders with optional filters. Supports full-text search by customer name or order number.
orders_get: Fetch a single order by UUID, optionally including customer and line items.
orders_create: Create a new order with start/end dates and optional customer/location.
orders_update: Update an existing order's attributes by UUID.
orders_get_items: Get all items (charge lines) of an order with product details (title, quantity, price, SKU, photo URL) in a single API call.

System

ping: Health check — returns a simple pong to verify connectivity.

Setup & Installation

Clone the repository:

git clone https://github.com/Themetralla3000/booqable-mcp-server.git
cd booqable-mcp-server

Install dependencies:
```
npm install
```
Configure your API keys in the environment file (.env):
```
cp .env.example .env
```
Build the project:
```
npm run build
```

Configuration

Edit the .env file with your Booqable instance details. You can generate an API key from your Booqable settings dashboard:

BOOQABLE_COMPANY_SLUG=your-company-slug
BOOQABLE_API_KEY=your_api_key_here

Usage with Claude Desktop / Cursor

To use this MCP with Claude Desktop or Cursor, add the following configuration to your MCP config file (e.g., claude_desktop_config.json):

{
  "mcpServers": {
    "booqable": {
      "command": "node",
      "args": ["/absolute/path/to/booqable-mcp-server/dist/index.js"],
      "env": {
        "BOOQABLE_COMPANY_SLUG": "your-company-slug",
        "BOOQABLE_API_KEY": "your_api_key_here"
      }
    }
  }
}