# Workiz MCP by usefulapi

> Workiz MCP by usefulapi is an MCP server. Manage Workiz jobs and leads: create, update, assign team members and convert leads to jobs. It runs as a hosted remote server, so there is nothing to install locally.

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

## About

Manage Workiz jobs and leads: create, update, assign team members and convert leads to jobs.

## Install

### Claude Code (Terminal)

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

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

```sh
https://workiz.usefulapi.io/mcp
```

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

```json
{
  "mcpServers": {
    "workiz": {
      "url": "https://workiz.usefulapi.io/mcp"
    }
  }
}
```

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

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

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

```json
{
  "mcpServers": {
    "workiz": {
      "serverUrl": "https://workiz.usefulapi.io/mcp"
    }
  }
}
```

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

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

## Tools

- `workiz_list_jobs`: List jobs, most recently scheduled first (sorted by JobDateTime, descending). Filter by start date, open-only, and status; page with offset/records (max 100). Without start_date Workiz returns the last 14 days. Workiz: GET /job/all/.
- `workiz_get_job`: Fetch one job by UUID: schedule, status, client contact and address, totals and amount due, notes, tags and assigned team. Workiz: GET /job/get/{UUID}/.
- `workiz_list_leads`: List leads, most recent first (sorted by LeadDateTime, descending). Filter by start date, open-only, and status; page with offset/records (max 100). Workiz: GET /lead/all/.
- `workiz_get_lead`: Fetch one lead by UUID: schedule, status, client contact and address, source, notes and assigned team. Workiz: GET /lead/get/{UUID}/.
- `workiz_list_team`: List the account's active team members: id, name, role, whether they are a field tech, email, service areas and skills. Use the name to assign people to jobs or leads. Workiz: GET /team/all/.
- `workiz_get_team_member`: Fetch one team member by user id: name, role, field-tech flag, email, service areas, skills and active status. Workiz: GET /team/get/{USER_ID}.
- `workiz_list_time_off`: List FUTURE time off (start, end, userName — 'Entire Business' for company-wide closures). Set all=true to include every user and company time off. Useful before scheduling. Workiz: GET /TimeOff/get/.
- `workiz_get_user_time_off`: List one team member's FUTURE time off, by their name. Workiz: GET /TimeOff/get/{USER_NAME}.
- `workiz_create_job`: WRITE: create a new job (schedule, client contact and address, type, source, notes). Returns the new job's UUID, ClientId and app link. Workiz: POST /job/create/.
- `workiz_update_job`: WRITE: update fields on an existing job — status/sub-status, reschedule (JobDateTime/JobEndDateTime), contact, address, type, source, notes, tags. Only the fields you pass are sent. Workiz: POST /job/update/.
- `workiz_assign_job`: WRITE: assign a team member (by name) to a job. Reversible with workiz_unassign_job. Workiz: POST /job/assign/.
- `workiz_unassign_job`: WRITE: remove a team member (by name) from a job. Reversible with workiz_assign_job. Workiz: POST /job/unassign/.
- `workiz_create_lead`: WRITE: create a new lead (client contact and address, requested time, job type, source, notes). Returns the new lead's UUID, ClientId and app link. Workiz: POST /lead/create/.
- `workiz_update_lead`: WRITE: update fields on an existing lead — status, schedule, contact, address, type, source, notes, tags. Only the fields you pass are sent. Workiz: POST /lead/update/.
- `workiz_assign_lead`: WRITE: assign a team member (by name) to a lead. Reversible with workiz_unassign_lead. Workiz: POST /lead/assign/.
- `workiz_unassign_lead`: WRITE: remove a team member (by name) from a lead. Reversible with workiz_assign_lead. Workiz: POST /lead/unassign/.
- `workiz_convert_lead_to_job`: WRITE (no API undo): convert a lead into a job. Creates a new job from the lead and returns its UUID and link; the API cannot reverse the conversion. Workiz: POST /lead/convert/.
- `workiz_mark_lead_lost`: WRITE: mark a lead as lost. Reversible with workiz_activate_lead. Workiz: POST /lead/markLost/{UUID}/.
- `workiz_activate_lead`: WRITE: change a lost lead back to active. Workiz: POST /lead/activate/{UUID}/.

## FAQ

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

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

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