# Workiz MCP connector

The Workiz connector lets Claude, ChatGPT, Cursor, Microsoft Copilot and the Elaichi Agent look up and update clients, calls, client notes, ad groups and availability in Workiz, with every action running as the signed-in person and recorded in an audit log.

Source: https://elaichi.ai/connectors/workiz/

## Facts

| | |
| --- | --- |
| Application | Workiz |
| Category | CRM |
| AI tools | 98 |
| Authentication | Connects with an API key |
| Bring your own OAuth app | No |
| MCP endpoint | https://api.elaichi.ai/mcp |
| Works with | Claude, ChatGPT, Cursor, Microsoft Copilot, any MCP client, and the Elaichi Agent |
| Tools advertised by name | No. Connected tools are never listed one by one, however few there are. The endpoint advertises `search_tools` and `execute_tool` instead |

## What you can ask once Workiz is connected

- Which availability slots are open tomorrow afternoon?
- Add a note to the Johnson client about the gate code.
- List this morning's calls and which clients they belong to.

## Connect Workiz in Elaichi

This happens once for the organization, before any client is involved.

1. Open Connections, choose Add connection, and pick Workiz.
2. Optionally set Share with, then press Connect.
3. Paste a Workiz API key. One person generates a token in Workiz and pastes it once. Everyone else works through Share with, and never sees it.

Credentials are vaulted and nobody, including the AI, reads them back. The connection becomes a toolbox immediately, so you can curate which Workiz tools are exposed, rename them, or freeze arguments before anyone points a client at it.

## Workiz MCP connector for Claude

Endpoint: https://api.elaichi.ai/mcp

1. Open Customize, then Connectors.
2. Press Add.
3. Name it, paste the MCP server URL, then Continue.
4. Sign in and approve.

On Team and Enterprise, an Owner adds it once. Everyone else turns it on for themselves.

## Workiz MCP connector for Claude Code

Endpoint: https://api.elaichi.ai/mcp

1. In a terminal, run `claude mcp add` with the endpoint.
2. Start Claude Code and run `/mcp`.
3. Pick elaichi, then sign in and approve in the browser.

```bash
claude mcp add --transport http elaichi --scope user https://api.elaichi.ai/mcp
```

Use `--scope project` instead to share it with the repository through `.mcp.json`.

## Workiz MCP connector for ChatGPT

Endpoint: https://api.elaichi.ai/mcp

1. Open Plugins, then press the + button.
2. Name it and paste the endpoint into Server URL.
3. Leave Authentication on OAuth, then tick the risk acknowledgement.
4. Press Create, then sign in and approve.

Works on the web. The plugin directory lives at chatgpt.com/plugins.

## Workiz MCP connector for Cursor

Endpoint: https://api.elaichi.ai/mcp

1. Open `~/.cursor/mcp.json`.
2. Add the endpoint under `mcpServers`.
3. Reload Cursor, then sign in and approve.

Set up per machine, so repeat it on each computer you work from.

## Workiz MCP connector for Microsoft Copilot

Endpoint: https://api.elaichi.ai/mcp

1. In Copilot Studio, open your agent, then Tools, Add a tool, New tool and Model Context Protocol.
2. Paste the endpoint into Server URL, choose OAuth 2.0, then Dynamic discovery, and press Create.
3. Create a new connection, sign in and approve, then press Add to agent.
4. Under Channels, open Teams and Microsoft Copilot and make the agent available in Microsoft Copilot.

Microsoft Copilot was called Microsoft 365 Copilot. Keep the tool on end-user credentials, so each person signs in as themselves.

## Connect Workiz to any MCP client

Endpoint: https://api.elaichi.ai/mcp

1. Add the endpoint as a remote MCP server.
2. Sign in and approve.

The Elaichi Agent already has these tools, with nothing to set up.

## What the consent screen decides

Every scope the client asks for starts ticked except "Delete things", which you tick yourself. Calling a Workiz tool needs "Use your connected apps". Over MCP there is no trusted place to confirm a write in the moment, so the consent screen is the standing approval rather than a formality. Think hard before granting Use your connected apps, which can also delete in connected apps and cannot be undone.

## What teams do with Workiz through Elaichi

### Catch a client up after a call

Office. Pull up the call that just came in, find the Workiz client it belongs to, and add a note on what was agreed before the next line rings.

### Check who is free before promising a time

Dispatch. Ask which availability slots are open this afternoon and what is already blocking the calendar, then commit to a window you can keep.

### Add a new client while still on the phone

Sales. Create the client in Workiz from a few details and attach a note on what they need, so the lead never sits in a notepad.

### Keep ad groups tidy

Marketing. List the ad groups Workiz is tracking, rename the ones that drifted, and remove the ones for campaigns that have ended.

### Read the history before you call back

Customer service. Ask for every note on a client and the recent calls tied to them, and get the whole story in one place.

### Shape the fields the office actually uses

Operations. Add a custom field or regroup the existing ones so technicians capture the gate code, the dog's name, or the best time to call.

## Elaichi vs Zapier MCP vs Composio for Workiz

All three can connect Workiz to an AI assistant, and all three have admin controls. They differ in where access lives and how you pay.

| What to check | Elaichi | Zapier MCP | Composio |
| --- | --- | --- | --- |
| Where the AI connects | One address for the whole organization. Endpoint: https://api.elaichi.ai/mcp | A server per member, created at sign-in. | An MCP endpoint per team, or an SDK. |
| Control over Workiz tools | Allow or restrict single Workiz tools, per role or user. | App and action restrictions on the account. | Role permissions, down to the action. |
| Record of calls | One audit entry per Workiz call. | A History tab of tool calls. | A log of every tool call. |
| Single sign-on | SAML or OIDC, plus SCIM, on Gold. | SAML on Enterprise. | SAML and OIDC on Enterprise. |
| Price | Free for one person; $15 per user per month on Gold. | 2 tasks per successful call. | Billed per tool call. |

Sources: Zapier MCP [docs](https://docs.zapier.com/mcp/get-started/quickstart), [security](https://docs.zapier.com/mcp/manage/security), [usage](https://docs.zapier.com/mcp/features/usage); Composio [docs](https://docs.composio.dev/docs/composio-connect), [gateway](https://composio.dev/mcp-gateway), [enterprise](https://composio.dev/enterprise), [pricing](https://composio.dev/pricing). Checked September 2026.

Longer take: [Zapier MCP alternative](/blog/zapier-mcp-alternative/) and [when you don't need an MCP gateway](/blog/when-you-dont-need-an-mcp-gateway/).

## Frequently asked questions

### How do I connect Workiz to Claude?

Open Elaichi, choose Workiz, and paste the API key from your Workiz account. There is no OAuth application to register and no client ID or secret to generate. Then in Claude go to Customize, then Connectors, then Add, and paste https://api.elaichi.ai/mcp. Sign in with your Elaichi account and Workiz is available in Claude.

### Does Workiz work with ChatGPT and Cursor as well as Claude?

Yes. Once Workiz is connected in Elaichi, the same endpoint, https://api.elaichi.ai/mcp, works in Claude, ChatGPT, Cursor, Microsoft Copilot, any MCP client and the Elaichi Agent. You connect Workiz once and every client picks it up.

### What can an AI agent actually do with my Workiz data?

It can find a Workiz client, read and add client notes, list recent calls and open a specific one, check availability slots and what is blocking the calendar, and create or clean up ad groups and custom fields. You ask in plain language, such as which slots are open tomorrow or add a note to this client. Short, concrete asks work better than long paragraphs.

### Does connecting Workiz give the AI everything in my account?

No. Every call into Workiz runs as the person who signed in to Elaichi, so the agent sees only what that person's Workiz access allows. Elaichi can narrow that further with roles and restrictions, and it never widens it beyond what the person already has.

### Can my team share one Workiz connection?

Yes. One person connects Workiz in Elaichi and shares the connection with a team, and nobody else ever handles the API key. Each teammate still signs in to Elaichi as themselves, so the audit log names the person behind every Workiz action.

### Can I stop an agent from deleting or changing things in Workiz?

Yes. Restrictions in Elaichi apply per action, so you can allow reading Workiz clients and notes while restricting deleting ad groups or custom fields, for a role or for one person. A restricted tool still shows up in Elaichi's tool search, flagged as restricted, but no client can run it, whatever the prompt says.

### What happens to a Workiz connection when someone leaves?

Offboarding that person in Elaichi ends their access to Workiz through every client at once. A shared Workiz connection keeps working for everyone else on the team. If you disconnect Workiz in Elaichi, it disappears from Claude, ChatGPT, Cursor, Microsoft Copilot and every other client in one step.

### Does the Workiz MCP connector work with Gemini, Codex, Claude Code or other MCP clients?

Yes. Workiz is reached over the same MCP endpoint every client uses, so anything that speaks MCP can call it — Gemini, Codex, Claude Code, Windsurf, Cline, Zed and OpenCode among them — alongside Claude, ChatGPT, Cursor, Microsoft Copilot, and the Elaichi Agent. The tools on offer and the access behind them are identical whichever client asks. Only the setup screen differs.

### Is Elaichi an alternative to Zapier MCP for Workiz?

Yes. Both let Claude, ChatGPT or Cursor use Workiz. Zapier MCP fits a team that already automates in Zapier, since each person signs in and acts as themselves in that account. Elaichi fits when IT wants one address for the whole company, per-tool rules by role, and a record of every Workiz call.

### How is Elaichi different from Composio for Workiz?

Composio gives AI agents tools and sign-in handling across 1,000+ apps, for developers building agents or people using an assistant, billed per tool call. Elaichi gives a company's own people governed access to Workiz: one address, restrictions per role or user, and $15 per user per month. Both have role permissions and a log of every call.

## All 98 Workiz tools

Every tool below is callable through https://api.elaichi.ai/mcp once Workiz is connected, subject to the toolbox it is in and the restrictions on the caller.

- **Create a Workiz ad group** (Create). Create a new Ad Group. Creates a new Ad Group and returns the created Ad Group object. Required: name, displayOrder.
- **Delete a Workiz ad group by ID** (Delete). Disable an Ad Group. Disables an Ad Group by its ID. Required: id.
- **Get single Workiz ad group by ID** (Get). Retrieve a single Ad Group. Retrieves a single Ad Group by its ID. Required: id.
- **List all Workiz ad groups** (List). Retrieve a list of Ad Groups. Retrieves a paginated list of Ad Groups. The connector pages through all results (page; limit sets pageSize).
- **Update a Workiz ad group by ID** (Update). Update an existing Ad Group. Updates an existing Ad Group and returns the updated Ad Group. Required: id.
- **List all Workiz availability blocking entities** (List). Retrieve blocking entities for a date. Returns the entities (jobs, leads, tasks, events, recurrences, time-offs) that are occupying capacity on the requested date, including fully booked slots. Use this endpoint to investigate why a specific date has reduced or no availability. Beta in Workiz's reference. One response, no paging. Required: date.
- **List all Workiz availability slots** (List). Retrieve booking availability. Returns the list of available booking slots for the account within the requested date range. Only slots that still have open capacity are returned, so a day with no returned slots is fully booked or unavailable. Beta in Workiz's reference. One response, no paging.
- **Get single Workiz call by ID** (Get). Retrieve a single Call. Retrieves a single Call by its ID, including its AI insights, transcript, and caller locations. Beta in Workiz's reference. Required: id.
- **List all Workiz calls** (List). Retrieve a list of Calls. Retrieves a paginated list of Calls, newest first by default. When no date filter is provided, results default to the last 30 days. Pass dateProperty, dateOperator, and date together to override this default. Dates are in the account timezone. Beta in Workiz's reference. The connector pages through all results (page; limit sets pageSize).
- **Create a Workiz client note** (Create). Create a new Client Note. Creates a new note for the given client. Required: client_id, note.
- **Delete a Workiz client note by ID** (Delete). Delete a Client Note. Deletes a note belonging to the given client. Required: id, client_id.
- **Get single Workiz client note by ID** (Get). Get a client note by ID. Returns a single note belonging to the given client. Required: id, client_id.
- **List all Workiz client notes** (List). Retrieve a list of Client Notes. Returns a paginated list of notes for the given client, ordered by creation date descending. Required: client_id. The connector pages through all results (page; limit sets pageSize).
- **Update a Workiz client note by ID** (Update). Update a Client Note. Updates the content and/or pinned state of a note belonging to the given client. Required: id, client_id.
- **Create a Workiz client** (Create). Create a new Client. Creates a new client and returns the created client object. Either email or primaryPhone must be provided. The client's service location is created from addressDetails. Optionally accepts a billing address, an ad group, a parent client, tax exemption details, and custom field values. Required: firstName.
- **Get single Workiz client by ID** (Get). Get a client by ID. Returns a single client including full contact details, service and billing addresses, tags, ad group, notes, additional contacts, and custom field values. Required: id.
- **List all Workiz clients** (List). Retrieve a list of Clients. Returns a paginated list of clients. Supports full-text search, tag filtering, due-balance filtering, sorting, and date-range filtering. Results are sourced from Elasticsearch and include basic contact and address information. The connector pages through all results (page; limit sets pageSize).
- **Create a Workiz custom field group** (Create). Create a new Custom Fields Group. Creates a new Custom Fields Group and returns the created Custom Fields Group. Required: entityType, name.
- **Delete a Workiz custom field group by ID** (Delete). Delete a Custom Fields Group. Deletes a Custom Fields Group by its ID. Required: id.
- **Get single Workiz custom field group by ID** (Get). Retrieve a single Custom Fields Group. Retrieves a single Custom Fields Group by its ID. Required: id.
- **List all Workiz custom field groups** (List). Retrieve a list of Custom Fields Groups. Retrieves a paginated list of Custom Fields Groups, optionally filtered by entity type. The connector pages through all results (page; limit sets pageSize).
- **Update a Workiz custom field group by ID** (Update). Update an existing Custom Fields Group. Updates an existing Custom Fields Group and returns the updated Custom Fields Group. Required: id.
- **Create a Workiz custom field** (Create). Create a new Custom Field. Creates a new Custom Field and returns the created Custom Field. Required: entityType, name, type.
- **Delete a Workiz custom field by ID** (Delete). Delete a Custom Field. Deletes a Custom Field by its ID. Required: id.
- **Get single Workiz custom field by ID** (Get). Retrieve a single Custom Field. Retrieves a single Custom Field by its ID. Required: id.
- **List all Workiz custom fields** (List). Retrieve a list of Custom Fields. Retrieves a paginated list of Custom Fields, optionally filtered by entity type. The connector pages through all results (page; limit sets pageSize).
- **Update a Workiz custom field by ID** (Update). Update an existing Custom Field. Updates an existing Custom Field and returns the updated object. Required: id.
- **Create a Workiz estimate payment** (Create). Add a payment to an Estimate. Adds a payment to an Estimate and returns the created payment. When the Estimate is linked to a Job the payment is shared by both, and the Job totals are recalculated as a side effect. Beta in Workiz's reference. Required: estimate_id, type, amount.
- **Create a Workiz estimate** (Create). Create a new Estimate. Creates a new Estimate for a client. When jobId is provided, the estimate is attached to that job or lead (which must belong to the client) and numbered after it; otherwise a standalone estimate is created for the client. Beta in Workiz's reference. Required: clientId.
- **Get single Workiz estimate by ID** (Get). Retrieve a single Estimate. Retrieves a single Estimate by its ID. Required: id.
- **List all Workiz estimates** (List). Retrieve a list of Estimates. Retrieves a paginated list of Estimates, optionally filtered by date range. The connector pages through all results (page; limit sets pageSize).
- **Create a Workiz event** (Create). Create a new Event. Creates a new Event and returns the created Event object. Required: title, start, end.
- **Delete a Workiz event by ID** (Delete). Delete an Event. Deletes an Event by its ID. Required: id.
- **Get single Workiz event by ID** (Get). Retrieve a single Event. Retrieves a single Event by its ID. Required: id.
- **List all Workiz events** (List). Retrieve a list of Events. Retrieves a paginated list of Events. The connector pages through all results (page; limit sets pageSize).
- **Update a Workiz event by ID** (Update). Update an existing Event. Updates an existing Event and returns the updated Event. Required: id.
- **List all Workiz future time offs** (List). Retrieve future time offs. Retrieves a paginated list of future approved time offs based on the current date and pagination. The connector pages through all results (page; limit sets pageSize).
- **Create a Workiz invoice payment** (Create). Add a payment to an Invoice. Adds a payment to an Invoice and returns the created payment. Recalculates the invoice totals and amount due as a side effect. Beta in Workiz's reference. Required: invoice_id, type, amount.
- **Get single Workiz invoice by ID** (Get). Retrieve a single Invoice. Retrieves a single Invoice by its ID. Required: id.
- **List all Workiz invoices** (List). Retrieve a list of Invoices. Retrieves a paginated list of Invoices, optionally filtered by date range. The connector pages through all results (page; limit sets pageSize).
- **Get single Workiz item category by ID** (Get). Retrieve an item category. Retrieves a single item category by its ID. Beta in Workiz's reference. Required: id.
- **List all Workiz item categories** (List). Retrieve a list of item categories. Retrieves a paginated list of the item categories of the account. Categories are a tree: a top level category has a null parentId, and parentId can be used to list the direct children of a category. Beta in Workiz's reference. The connector pages through all results (page; limit sets pageSize).
- **Get single Workiz item by ID** (Get). Retrieve an item. Retrieves a single item by its ID. Beta in Workiz's reference. Required: id.
- **List all Workiz items** (List). Retrieve a list of items. Retrieves a paginated list of the price book and inventory items of the account. Use categoryId to list the items of a single category, serialId to fetch a specific set of items, and type, active, inventoryManaged and booking to narrow the list further. Beta in Workiz's reference. The connector pages through all results (page; limit sets pageSize).
- **Create a Workiz job payment** (Create). Add a payment to a Job. Adds a payment to a Job and returns the created payment. Recalculates the job totals and amount due as a side effect. Beta in Workiz's reference. Required: job_id, type, amount.
- **Create a Workiz job sub status** (Create). Create a new Job Sub Status. Creates a new Job Sub Status and returns the created Job Sub Status object. Required: name, parentName, color.
- **Delete a Workiz job sub status by ID** (Delete). Delete a Job Sub Status. Deletes a Job Sub Status by its ID. Required: id.
- **Get single Workiz job sub status by ID** (Get). Retrieve a single Job Sub Status. Retrieves a single Job Sub Status by its ID. Required: id.
- **List all Workiz job sub statuses** (List). Retrieve a list of Job Sub Statuses. Retrieves a paginated list of Job Sub Statuses. The connector pages through all results (page; limit sets pageSize).
- **Update a Workiz job sub status by ID** (Update). Update an existing Job Sub Status. Updates an existing Job Sub Status and returns the updated Job Sub Status. Required: id.
- ...and 48 more tools. Call `tools/list` via the MCP endpoint, or see the full catalog via the API, for the complete set.
