# Shop Boss MCP by usefulapi

> Shop Boss MCP by usefulapi is an MCP server. Read repair orders, appointments, customers, vehicles, parts and shop reference data. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/shop-boss/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/shop-boss
- **MCP Registry name:** io.usefulapi/shop-boss
- **Listing updated:** 2026-11-13

## About

Read repair orders, appointments, customers, vehicles, parts and shop reference data.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http shop-boss https://shop-boss.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://shop-boss.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "shop-boss": {
      "url": "https://shop-boss.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "shop-boss": {
      "type": "http",
      "url": "https://shop-boss.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "shop-boss": {
      "serverUrl": "https://shop-boss.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "shop-boss": {
      "type": "http",
      "url": "https://shop-boss.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `shopboss_list_appointments`: Review appointments, scheduled dates, customer and vehicle references. Dates use YYYY-MM-DD. Read-only. Resource permissions depend on your Shop Boss API key.
- `shopboss_list_customers`: Find customers by ID, name, email or phone and review their contact and account context. Read-only. Resource permissions depend on your Shop Boss API key.
- `shopboss_list_vehicles`: Find vehicles by ID, owner, VIN, make, model or year. Read-only. Resource permissions depend on your Shop Boss API key.
- `shopboss_list_repair_orders`: Review repair orders with customer, vehicle, complaint and status context. Filter by order ID, customer or VIN. Read-only. Resource permissions depend on your Shop Boss API key.
- `shopboss_list_order_parts`: Review parts, quantities, prices and ordering context associated with repair orders. Read-only. Resource permissions depend on your Shop Boss API key.
- `shopboss_list_parts`: Review inventory availability, reorder levels and part details. Read-only. Resource permissions depend on your Shop Boss API key.
- `shopboss_list_part_sales`: Review part-sale balances and statuses without taking payments or changing sales. Part-sale IDs may be negative, as shown in the vendor reference. Read-only. Resource permissions depend on your Shop Boss API key.
- `shopboss_list_recommended_repairs`: Review recommended or previously declined work for a customer or vehicle. Read-only. Resource permissions depend on your Shop Boss API key.
- `shopboss_list_canned_jobs`: Look up predefined automotive services and their pricing context. Read-only. Resource permissions depend on your Shop Boss API key.
- `shopboss_list_employees`: Look up employee names, job descriptions, mechanic numbers and active status. Payroll, home addresses and emergency contacts are omitted. Read-only. Resource permissions depend on your Shop Boss API key.
- `shopboss_list_suppliers`: Review supplier contact details and terms; account numbers are omitted. Read-only. Resource permissions depend on your Shop Boss API key.
- `shopboss_list_bays`: List available service bays for appointment planning. Read-only. Resource permissions depend on your Shop Boss API key.
- `shopboss_list_complaint_categories`: Look up the shop's repair complaint categories. Read-only. Resource permissions depend on your Shop Boss API key.
- `shopboss_list_shop_hours`: Review the shop's configured opening and closing hours. Read-only. Resource permissions depend on your Shop Boss API key.
- `shopboss_list_sources`: Review the shop's configured customer and appointment source labels. Read-only. Resource permissions depend on your Shop Boss API key.

## FAQ

### How do I add Shop Boss MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http shop-boss https://shop-boss.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/shop-boss-mcp-by-usefulapi
