Skip to main content
Glama
ServiceBox MCP Server

ServiceBox MCP Server

ServiceBox MCP server

Connect ServiceBox to ChatGPT, Claude and any AI agent through Cotlet.dev. Work in your own signed-in ServiceBox user with 21 hosted workflows for work orders, job costs, equipment, quotes, invoices and customer email. Write actions ask for approval by default.

What you can ask

List my unscheduled work orders.

Compare actual costs with the quote for a work order.

Show invoices nobody has opened.

Related MCP server: SalonBiz MCP server

Connect in 2 minutes

Get your API key at https://cotlet.dev/app and export it as COTLET_API_KEY.

ChatGPT

Settings → Apps & Connectors → Create, with connector URL https://cotlet.dev/mcp/v1/connect, then sign in with Cotlet.dev. No API key needed.

Claude

Settings → Connectors → Add custom connector, with URL https://cotlet.dev/mcp/v1/connect, then sign in with Cotlet.dev.

Claude Code

claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"

Cursor

Copy .cursor/mcp.json from this repo into your project:

{
  "mcpServers": {
    "cotlet": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": {
        "Authorization": "Bearer ${COTLET_API_KEY}"
      }
    }
  }
}

Run it locally (stdio)

This repo is a real MCP server. It speaks MCP over stdio, lists its ServiceBox tools without any key, and forwards every tool call to the hosted Cotlet.dev server. The hosted URL above stays the recommended way. Use this when your client only starts local servers.

Run the included Python module with Python 3.10 or later:

python3 servicebox_agent.py serve

Or with Docker:

docker build -t servicebox-mcp .
docker run -i --rm -e COTLET_API_KEY servicebox-mcp

Tools: servicebox_guide, servicebox_status, servicebox_open, servicebox_read, servicebox_click, servicebox_type, servicebox_close. Without COTLET_API_KEY a tool call answers: "Set COTLET_API_KEY. Get a key at https://cotlet.dev/app".

Command line

Python 3.10+, with no third-party runtime dependencies. Clone this repository and run:

export COTLET_API_KEY="your-key"
python3 servicebox_agent.py connect   # ready config for ChatGPT, Claude, Claude Code and Cursor
python3 servicebox_agent.py status    # is ServiceBox ready in your Cotlet.dev account
python3 servicebox_agent.py guide     # ServiceBox screens and sign-in link
python3 servicebox_agent.py read      # open ServiceBox, read the page, close the browser
python3 servicebox_agent.py tools     # list Cotlet.dev tools
python3 servicebox_agent.py serve     # start the stdio MCP server (same as no argument)

Questions from ServiceBox users

Which ServiceBox user should I connect?

Sign in at https://jb.jobboxsoft.com/servicebox in your Cotlet Cloud Browser. An administrator sees every work order; a basic user sees only assigned work orders.

Which actions ask for approval?

The hosted integration has 8 read tools and 13 write tools. Every write asks for approval by default.

Is Cotlet affiliated with ServiceBox?

No. Cotlet.dev is independent and not affiliated with ServiceBox or Jobbox Software.

Learn more


More: https://cotlet.dev/integrations/servicebox-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=servicebox

Request access: https://cotlet.dev/signup?app=servicebox&utm_source=github&utm_medium=readme&utm_campaign=servicebox

Workflows on the hosted integration

The live integration page documents these 21 operations:

  • list_work_orders

  • save_work_order

  • schedule_work_order

  • attach_checklist

  • add_inventory_to_work_order

  • add_service_charge

  • record_purchase_order

  • get_job_costing

  • list_units

  • manage_units

  • move_job_site

  • import_export_records

  • list_quotes

  • create_quote

  • set_quote_financing_terms

  • list_invoices

  • get_invoice_statistics

  • manage_invoices

  • manage_payments

  • get_email_log

  • search_address_book

The local stdio adapter exposes seven browser helpers listed above. These helpers forward to Cotlet.dev; the workflow operations are documented on the hosted integration page.

Available Tools

7 tools
servicebox_clickB

Click a numbered element on the current ServiceBox page.

Inputs: element (required).

servicebox_closeA

Close the ServiceBox browser session when the work is done, so credits stop running.

Inputs: no named parameters.

servicebox_guideA

How to work in ServiceBox (dispatch work orders, compare job costs and manage quotes and invoices): its screens and the sign-in link. Call this first.

Inputs: task.

servicebox_openB

Open a ServiceBox page in your signed-in Cloud Browser (default https://jb.jobboxsoft.com) to work with dispatch work orders, compare job costs and manage quotes and invoices.

Inputs: url.

servicebox_readA

Read the current ServiceBox page: its text and numbered buttons, links and fields.

Inputs: element.

servicebox_statusA

Check that your Cotlet.dev account and ServiceBox are ready: account, credits and ServiceBox connection.

Inputs: no named parameters.

servicebox_typeB

Type text into a numbered field on the current ServiceBox page.

Inputs: text (required), element (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool maps to a distinct phase of browser work: guide/status for setup checks, open/close for session lifecycle, and read/click/type for page interaction. The guide and status tools have slightly different purposes (instructions vs readiness diagnostics), and no two tools appear interchangeable.

    Naming Consistency4/5

    All tools share a clear servicebox_ prefix and are readable, with mostly action-oriented names (open, read, click, type, close). The nouns guide and status are minor deviations from the verb pattern but remain predictable.

    Tool Count5/5

    Seven tools is well-scoped for a browser-automation workflow: a compact setup, interaction, and cleanup loop without redundant tools.

    Completeness4/5

    The core browser lifecycle is covered: open a page, read it, click and type on numbered elements, then close the session. Minor gaps exist around navigation/history, waits, or richer form controls, but agents can work around them via links and repeated reads.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    • ServiceTrade MCP server for ChatGPT, Claude and any AI agent: list jobs, create appointment, release appointment to technicians, list deficiencies, create quote, submit quote and add comment to job in your own ServiceTrade account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to ServiceTrade yourself; Cotlet does not store your password and you need no ServiceTrade API key. About the official ServiceTrade API: ServiceTrade has a full REST API with public docs and OAuth2 client-credentials sign-in, but no official MCP server (checked 23 Oct 2026). The API covers jobs, appointments, deficiencies and quotes, so the missing piece is the agent layer: you build and host the wrapper yourself. Setup and FAQ: https://cotlet.dev/integrations/servicetrade-api-mcp-server

    • Service Autopilot MCP server for ChatGPT, Claude and any AI agent: create job, reschedule visit, send estimate, list invoices, add client and get route in your own Service Autopilot account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Service Autopilot yourself; Cotlet does not store your password and you need no Service Autopilot API key. About the official Service Autopilot API: Service Autopilot has no public API, developer portal or self-service API keys (checked 11 Oct 2026). Data moves through a two-way QuickBooks sync, a few partners the vendor picks, a Zapier trigger that only sends completed jobs out, and manual import and export; the QuickBooks sync needs the Pro or Pro Plus plan. Setup and FAQ: https://cotlet.dev/integrations/service-autopilot-api-mcp-server

    • FieldEdge MCP server for ChatGPT, Claude and any AI agent: create work order, dispatch technician, list customers, send invoice and list unpaid invoices in your own FieldEdge account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to FieldEdge yourself; Cotlet does not store your password and you need no FieldEdge API key. About the official FieldEdge API: FieldEdge has an API, but only on request: customers ask for access through FieldEdge's onboarding form and get credentials for an app FieldEdge provisions (checked 8 Nov 2026). There are no self-service keys and no official MCP server. Setup and FAQ: https://cotlet.dev/integrations/fieldedge-api-mcp-server

    • Workiz MCP server for ChatGPT, Claude and any AI agent: list jobs, schedule job, create invoice and record payment in your own Workiz account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Workiz yourself; Cotlet does not store your password and you need no Workiz API key. About the official Workiz API: Workiz has an official REST API, but only on the Ultimate plan, and it covers jobs, leads, team members and time off (checked 11 Oct 2026). Estimates, invoices and clients have no endpoints. Setup and FAQ: https://cotlet.dev/integrations/workiz-api-mcp-server

      https://cotlet.dev/mcp/v1/workiz

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Connects AI agents to a signed-in contractor account through Cotlet.dev so they can work with estimates, leads, change orders, and job costs. Supports drafting line items, tracking estimate views, reading margins and recorded costs, and reviewing changes before writes are sent.
      Elastic 2.0
    • A
      license
      A
      quality
      B
      maintenance
      Connects a signed-in SalonBiz account to ChatGPT, Claude, Codex, and Claude Code via Cotlet.dev, enabling users to read appointments, tickets, inventory, payments, and reports and to make booking, online booking, and campaign changes with approval by default.
      7
      Elastic 2.0
    • A
      license
      A
      quality
      C
      maintenance
      Enables ChatGPT, Claude and other AI agents to manage availability, blocked time, forms, invoices and client reports in a signed-in account, with write actions requiring approval by default. It connects through Cotlet.dev either as a hosted endpoint or as a local stdio server that forwards tool calls.
      7
      Elastic 2.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to work inside a signed-in field-service account through Cotlet.dev — scheduling recurring jobs, finding customers, creating invoices and recording payments — with invoices, reminders and crew messages held for approval by default.
      Elastic 2.0