Workiz MCP Server

Jobs, scheduling, invoices and payments for field service.

Hosted MCP Server

npx add-mcp 'https://cotlet.dev/mcp/v1/workiz'

Installs into Claude Code, Codex, Cursor and more

Documentation

Cotlet · Integrations · How it works · Security · For developers · For automation agencies · Blog · API docs · Help center · Changelog · Contact · Pricing · Sign up

Workiz API and MCP server: Let your AI agent book the leads and bill the jobs.

Workiz has no official MCP server. Its REST API is included only in the Ultimate plan and covers jobs, leads, team members and time off; clients, estimates and invoices have no endpoints (OpenAPI spec, checked 14 Nov 2026). Cotlet runs 15 Workiz tools hosted, over MCP for agents and REST for scripts, in your own login on Standard, Pro or Ultimate.

Jobs, scheduling, invoices and payments for field service. Use it in ChatGPT, Claude or any AI agent over MCP, or in n8n, Make and scripts over REST.

MCP setup REST API guide

What can you automate in Workiz?

  • Book new leads into the first free slot
  • Invoice and send yesterday's Done jobs
  • Log the checks and cash techs bring back
  • Hand a sick tech's jobs to whoever is free
  • Resend estimates still waiting for a yes
  • List unpaid invoices, oldest due date first

Does Workiz have an MCP server or an API?

  • The Workiz API logs a payment on a job only as cash, credit or check, and lists jobs 100 per call.
  • The Workiz Zapier app also needs Ultimate: 5 triggers and 2 actions, Create Job and Create Lead.
  • Workiz Genius answers calls, emails and texts as a paid add-on; Genius Scheduling suggests slots on Pro and Ultimate.
What you needWorkiz APIZapierCotlet
Jobs, leads and tech assignmentsYes, on UltimateCreate a job or leadYes
Estimates and invoicesNo endpointsNoYes, sending after your OK
Find a client and their balanceNo endpointNoYes
Workiz plan neededUltimateUltimateThe one you have
Developer neededYesNoNo

Checked 14 Nov 2026. Sources: Workiz API OpenAPI spec, Workiz pricing and plan comparison, Workiz on Zapier, Workiz by Maxmel Tech on Make

How does Cotlet connect to Workiz?

  1. Sign in to Workiz. Use your own account in its Cotlet Cloud Browser.
  2. Choose MCP or REST. Connect your agent or create a Cotlet API key.
  3. Run your workflow. Ask your agent or send an HTTP request.

Cotlet never sees or stores your Workiz password. New jobs, moved jobs, sent estimates and invoices, and logged payments wait for your OK.

Connect Workiz to your agent or workflow

Use MCP with your AI agent, or HTTP requests in n8n, Make, Zapier and scripts. Follow the MCP setup below or jump to the REST guide.

  1. Sign in to Workiz in a Cloud Browser. Open app.workiz.com/login in your Cotlet Cloud Browser and log in as the office user whose work the agent takes over.
  2. Add the Cotlet address. Enter https://cotlet.dev/mcp/v1 as the MCP server or connector URL in your agent.
  3. Let the agent in and hand it the leads. Chat apps open a Cotlet sign-in page; editors, n8n and scripts send an API key from the console. Then ask it to book yesterday's leads into free slots.

Workiz sits on the shared address https://cotlet.dev/mcp/v1 with every other app you turn on, so one connector covers your field service stack. Turned Workiz on after connecting? Refresh the connector and its 15 tools show up.

ChatGPT:

Settings > Apps & Connectors > Create
MCP server URL: https://cotlet.dev/mcp/v1/connect
Authentication: OAuth

Claude:

Settings > Connectors > Add custom connector
URL: https://cotlet.dev/mcp/v1/connect

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

Cursor:

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

Codex:

# ~/.codex/config.toml
[mcp_servers.cotlet]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"

n8n:

MCP Client Tool (inside an AI Agent)
Transport: HTTP Streamable
URL: https://cotlet.dev/mcp/v1
Auth: Bearer, <your key>
Tool: workiz_read

Make, Zapier:

Make: MCP Client > Call a tool
Zapier: MCP Client by Zapier > Run Tool
Server URL: https://cotlet.dev/mcp/v1
Token: <your key>
Tool: workiz_write

How to use the Workiz REST API

Create your Cotlet API key

Create a Cotlet API key with access to Workiz and its read operations. Store it as COTLET_API_KEY in your environment or automation platform's credential store.

Connect Workiz in Cotlet and enable it for agents. Account access: Your own Workiz account (the permissions of your role apply).

Make your first Workiz API request

REST:

curl "https://cotlet.dev/api/v1/workiz/jobs?from=2026-10-09&to=2026-10-09&limit=5" \
  -H "Authorization: Bearer $COTLET_API_KEY"

Read jobs and apply the operation limits

A successful REST call puts the tool output in result. This illustrative response excerpt omits call IDs, messages and credit details.

Illustrative response excerpt:

{
  "status": "success",
  "app": "workiz",
  "tool": "list_jobs",
  "result": {
    "jobs": [
      {
        "job_id": "7c1e5a90-2b4d-4f6e-9a31-0d8e2c4b6f17",
        "status": "Done",
        "job_type": "Water heater install",
        "scheduled_start": "2026-10-09T09:00:00-07:00",
        "client": {
          "client_id": "cl_5521",
          "name": "Dana Whitfield"
        },
        "address": "12 Oak St, Sacramento, CA",
        "techs": [
          "Mike R."
        ],
        "total": "480.00",
        "amount_due": "480.00"
      }
    ],
    "next_cursor": null
  }
}

Returns jobs in a date range, newest first, with status, client, address, assigned team members, total and amount due. Pages hold up to 100 jobs; pass next_cursor back as cursor for the next page.

Filter by status or by team member to narrow the list.

from: First scheduled date. Default: 14 days ago.

to: Last scheduled date. Default: today.

limit: 1 to 100. Default: 50.

cursor: Next page cursor from the previous call.

Keep the same selection when continuing a list. Compare changed record values as well as identifiers when refreshing your destination.

Workiz workflows for agents and automations

ToolConnect throughExample workflow
n8nHTTP RequestFull job: client, address, time window, job type, notes, items, total, amount due and payments. Use get_job in your configured business report.
MakeHTTP > Make a requestEstimates with client, total, status and the date they were sent. Use list_estimates in your configured business report.
Python or Node.jsREST APIInvoices with job, client, total, amount due and due date. Use list_invoices in your configured business report.

Send Authorization: Bearer <your Cotlet API key> in request headers. You configure the schedule, destination and record comparisons.

Cotlet reads Workiz; your workflow steps write to your chosen destination. These HTTP workflows do not require a native Cotlet connector or a prebuilt template.

Python and Node.js can use the same HTTP requests without an AI agent. Keep access keys in credentials, outside shared workflow exports.

The API and MCP reference lists operations and inputs. The REST API guide explains authentication, errors and approvals.

Workiz API endpoints and MCP tools

Seven of these tools do what the Workiz API also does on Ultimate. The rest, clients, estimates and invoices, have no Workiz API at all.

Jobs and schedule

Jobs come 100 per page by scheduled date. get_schedule shows each tech's jobs and time off, so a booking or a move lands in a window that is really free; Workiz itself warns about a conflict but never blocks it.

  • List jobs (list_jobs, read): Jobs by scheduled date, with status, client, address, assigned techs and amount due.
  • Get job (get_job, read): Full job: client, address, time window, job type, notes, items, total, amount due and payments.
  • Get schedule (get_schedule, read): Jobs and time off per technician for a day or range, as on the Workiz calendar.
  • Create job (create_job, write, asks first): New job for an existing or new client, with job type, time window and notes.
  • Reschedule job (reschedule_job, write, asks first): Move a job to a new time window. Changes the client's appointment.
  • Assign job (assign_job, write): Assign or unassign team members on a job.

Leads and clients

Submitting a Workiz lead also creates a client, so list_clients finds that record by phone before a job is booked on it.

  • List leads (list_leads, read): Leads with status, source, client details and assigned team member.
  • List clients (list_clients, read): Search clients by name, phone, email or address, with past jobs and balance due.

Estimates

Item names match your Price Book. A draft reaches no client until send_estimate, which links to approval in the client portal.

  • List estimates (list_estimates, read): Estimates with client, total, status and the date they were sent.
  • Create estimate (create_estimate, write): Draft estimate for a client with items from your Price Book. Nothing is sent yet.
  • Send estimate (send_estimate, write, asks first): Email or text an estimate to the client, with a link to approve it.

Invoices and payments

An invoice made from a job copies its items. Payments are cash, check or credit you already received; no tool charges a card.

  • List invoices (list_invoices, read): Invoices with job, client, total, amount due and due date.
  • Create invoice (create_invoice, write): Invoice for a job with its items and total. Nothing is sent yet.
  • Send invoice (send_invoice, write, asks first): Email or text an invoice to the client, with a link to pay online.
  • Record payment (record_payment, write, asks first): Record a payment you already received on a job. Does not charge a card.

Inputs, REST path and example response of every tool: https://cotlet.dev/integrations/workiz-api-mcp-server#tools

Who can see my Workiz session, and how do I revoke it?

  • What we store. Your signed-in Workiz browser profile, AES-256-GCM encrypted, in Finland. Never your password.
  • What your agent gets. The 15 Workiz tools, nothing else from the account.
  • What the session sees. The jobs, leads, clients and invoices your Workiz role can open.
  • What no tool touches. Workiz Pay card charges, Genius Phone calls and texts, Automations rules, Price Book edits, users and roles, deletes.
  • If Workiz signs you out. One click in the Cotlet console reopens the browser to sign in.
  • How to cut access. Disable Workiz for agents, reset the browser, or change your password.

You type your Workiz password yourself, and the agent works only in the account that sign-in opens. Our site scores A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory (live results).

What happens when Workiz changes?

The Workiz MCP server works through the pages you use every day, so it keeps booking and billing when Workiz redesigns a screen. Cotlet watches the apps it serves and updates the server when Workiz changes.

When Workiz adds a feature to those pages, your agent can use it too. It still sees only what your own Workiz role can see.

Cotlet never sees or stores your password. If Workiz signs you out, one click in the Cotlet console reopens the Cloud Browser so you can sign in again.

Approvals, undo and mistakes

  1. Match the check to a job. list_jobs by client name or address.
  2. Compare it with the balance. get_job shows the amount due.
  3. Wait for your OK. The batch shows up in your Cotlet console.
  4. Log it with the check number. record_payment returns what is still due.
ActionHow to put it right
Tech assigned to a jobCall assign_job again with replace set to true
Job moved to a new windowMove it back with reschedule_job; a client text already sent stays sent
Job createdCancel it in Workiz
Draft estimate or invoiceNothing went out: edit or delete the draft
Payment logged on the wrong jobFix it on the job's Payments tab, then log it on the right job
Estimate or invoice sentAlready with your client: follow up with them

5 of 15 tools ask first: create_job, reschedule_job, send_estimate, send_invoice and record_payment. By default you confirm each call, and you can switch that off per tool once a routine has earned it. assign_job, create_estimate and create_invoice send nothing to a client, so they run at once, like the 7 read tools.

MCP call:

{
  "name": "record_payment",
  "arguments": {
    "job_id": "7c1e5a90-2b4d-4f6e-9a31-0d8e2c4b6f17",
    "amount": "240.00",
    "method": "check",
    "paid_at": "2026-10-09T15:30:00-07:00",
    "reference": "1042"
  }
}

REST:

curl -X POST https://cotlet.dev/api/v1/workiz/jobs/7c1e5a90-2b4d-4f6e-9a31-0d8e2c4b6f17/payments \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount":"240.00","method":"check","paid_at":"2026-10-09T15:30:00-07:00","reference":"1042"}'

Response:

{
  "job_id": "7c1e5a90-2b4d-4f6e-9a31-0d8e2c4b6f17",
  "payment_id": "pay_88213",
  "amount": "240.00",
  "method": "check",
  "reference": "1042",
  "job_total": "480.00",
  "amount_due": "240.00",
  "status": "recorded"
}

The example logs check no. 1042 for $240.00 on a $480.00 water heater job, so $240.00 stays due. A cron job or n8n flow can make the same call over REST at /api/v1/workiz with the same key and price, in JSON. Failed calls are free.

How much does the Workiz MCP server cost?

About $22 a month for a garage door and locksmith shop with 3 technicians, 3,820 credits. Your Workiz plan stays as it is.

JobCallsCredits
New lead booked into a free slot5 × 201,000
Done job invoiced and emailed3 × 20600
Checks and cash logged, weekly batch of 57 × 4280
Pending estimates resent, weekly5 × 4200
Done jobs with no invoice, weekly check2 × 480
Sick day: jobs reassigned or moved8 × 2160
Cloud Browser, 30 days1,500
Total232 calls3,820

The $29 pack covers a typical month for most owners.

  • Free 7-day trial, no card
  • 10 credits per successful call, MCP or REST
  • 50 credits a day for the Cloud Browser
  • Works on Standard and Pro, not only Ultimate

Workiz publishes no job counts, so the month is our example. Dollars at the $29 pack rate; packs are one-time purchases, not a subscription.

Workiz MCP server: other ways to connect

OptionWhat it doesWhere it stops
Workiz GeniusAnswers calls, emails and texts 24/7; Genius Scheduling suggests slots while you book.Built into Workiz screens; it takes no requests from ChatGPT or Claude.
Workiz AutomationsRules on job and lead status, such as creating an invoice when a job is Done.5, 10 or 30 rules by plan; a rule creates the invoice but sends nothing.
Workiz API20 endpoints for jobs, leads, team and time off; payments as cash, credit or check.Ultimate only; no clients, estimates or invoices; you write and host the code.
Zapier5 triggers (New Job, Job Is Done and more) and 2 actions: Create Job, Create Lead.Ultimate only; nothing for estimates, invoices or payments.
Make, n8nMake has a community app by Maxmel Tech; n8n has no Workiz node and calls the API over HTTP.Both run on the Ultimate API token and its endpoints.
ComposioHosted MCP with 21 Workiz tools for jobs, leads and technicians.Needs your Workiz API key, so Ultimate.
hoffnerheatingandair/workiz-mcp-serverSelf-hosted MCP server on the official API, by one HVAC company.0 stars, no license, last commit 18 Jul 2026; you deploy it.

If you are on Ultimate and only need jobs, leads and assignments, the Workiz API covers that. Cotlet is the only option where your agent does the daily office work on every Workiz screen you use, reading and writing estimates, invoices and payments too, from ChatGPT, Claude or any MCP client, with no API key and on your current plan.

Also listed on: Odel, mcpbeat

Who runs Cotlet

Cotlet is a product of Take Group sp. z o.o., a software company registered in Poland, EU (VAT PL6342984273), in business since 2019. Its founders are Bart Krawczyk (Co-founder, CTO) and Jake Slugocki (Co-founder, SEO, sales and marketing). Send questions about the Workiz tools to contact@cotlet.dev.

Workiz API and MCP: questions

How do I get access?

Sign up free at https://cotlet.dev, turn on Workiz under Integrations in the console and log in at app.workiz.com/login in your Cloud Browser. Then connect your AI agent and ask which Done jobs from yesterday still have no invoice. The trial needs no card.

How do I connect Workiz to ChatGPT or Claude?

Sign up at cotlet.dev, log in to Workiz once in its Cloud Browser and add Cotlet to ChatGPT or Claude, following the steps in your console. No API key is needed. ChatGPT and Claude then work in your Workiz account through Cotlet, in their phone apps too.

What can ChatGPT do in Workiz?

With Cotlet, ChatGPT, Claude and other AI agents handle jobs like these in Workiz: invoice completed jobs; follow up on unapproved estimates; log cash and check payments. You ask in plain words, and anything that reaches other people waits for your OK first.

Is there an official ChatGPT or Claude app for Workiz?

No. Workiz has no ChatGPT or Claude connector of its own (checked 8 Nov 2026). Cotlet is an independent one that works in ChatGPT, Claude, Cursor and any MCP client, on your signed-in account.

Can ChatGPT schedule a job in Workiz?

Yes, with Cotlet. ChatGPT creates the job, moves it to a new time and assigns it to a technician in your Workiz account. Creating and moving a job wait for your OK by default.

Can ChatGPT send an invoice in Workiz?

Yes, with Cotlet. ChatGPT creates the invoice for a completed job and sends it to the client, and it logs cash and check payments. Sending waits for your OK by default.

Do I need the Ultimate plan?

No. The Workiz Open API and Zapier integration are included only in the Ultimate plan (checked 11 Oct 2026), but Cotlet works in your own Workiz account on your current plan. What a tool can do follows your role in Workiz.

Can it charge a customer's card?

No. record_payment logs a cash, check or credit payment you already received. Clients pay online through the link in the invoice, in the Workiz client portal.

Which Workiz user should I sign in with?

The office or dispatcher user whose work the agent takes over. On Pro and Ultimate, Workiz roles and permissions decide what that user can open, and the agent sees the same.

Is the MCP server different from the REST API?

Only in how it is called. Both carry the same 15 tools, inputs, answers, API key and price. Agents use MCP; scripts and n8n HTTP steps use REST.

Is Cotlet affiliated with Workiz?

No. Cotlet is independent and not affiliated with Workiz.

Can I use the Workiz API without an AI agent?

Yes. Call Cotlet's REST API from a script or an HTTP step in n8n, Make or Zapier with your Cotlet key. MCP is the alternative for AI agents; you do not need to connect an agent to use REST.


Give your AI agents your signed-in browser.

Product: Integrations · How it works · Pricing · Security

Resources: Blog · API docs · Help center · Changelog · GitHub

Solutions: For developers · For automation agencies

Company: About · AI info: company facts · Contact

Legal: Terms of service · Privacy policy · Refund policy · Acceptable use · Cookie policy · DPA · Subprocessors

Elsewhere: Status page · Cotlet on GitHub · Cotlet on X · Cotlet on LinkedIn · Cotlet on Product Hunt · Cotlet on Crunchbase · Cotlet on SaaSHub

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. About us

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.