ServiceBox MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ServiceBox MCP Server list my unscheduled work orders"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 serveOr with Docker:
docker build -t servicebox-mcp .
docker run -i --rm -e COTLET_API_KEY servicebox-mcpTools: 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
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_orderssave_work_orderschedule_work_orderattach_checklistadd_inventory_to_work_orderadd_service_chargerecord_purchase_orderget_job_costinglist_unitsmanage_unitsmove_job_siteimport_export_recordslist_quotescreate_quoteset_quote_financing_termslist_invoicesget_invoice_statisticsmanage_invoicesmanage_paymentsget_email_logsearch_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 toolsservicebox_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
Scored across 7 tools
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.
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.
Seven tools is well-scoped for a browser-automation workflow: a compact setup, interaction, and cleanup loop without redundant tools.
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
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
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceConnects 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
- AlicenseAqualityBmaintenanceConnects 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.7Elastic 2.0
- AlicenseAqualityCmaintenanceEnables 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.7Elastic 2.0
- AlicenseNot gradedqualityCmaintenanceEnables 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