# Servicem8 (verified)

ServiceM8 helps field service businesses schedule jobs, send quotes, and manage invoices, offering staff mobile apps and real-time job status tracking

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add servicem8

# Browse available tools
npx -y @smithery/cli@latest tool list servicem8

# Get full schema for a tool
npx -y @smithery/cli@latest tool get servicem8 SERVICEM8_CREATE_JOB_NOTE

# Call a tool
npx -y @smithery/cli@latest tool call servicem8 SERVICEM8_CREATE_JOB_NOTE '{}'
```

## Direct MCP Connection

Endpoint: `https://servicem8.run.tools`

## Tools (28)

- `SERVICEM8_CREATE_JOB_NOTE` — Tool to create a new job note in ServiceM8. Use when you need to attach additional information to a specific job after …
- `SERVICEM8_CREATE_JOB_PAYMENT` — Tool to create a new job payment in ServiceM8. Use when you have collected payment details and need to record payment a…
- `SERVICEM8_CREATE_JOBS` — Tool to create a new Job in ServiceM8. Use when you have gathered all job details and need to push a record. Example: "…
- `SERVICEM8_DELETE_JOB_NOTE` — Tool to delete a specific job note. Use when you need to archive a note by its UUID.
- `SERVICEM8_DELETE_JOB_PAYMENT` — Tool to delete (archive) a specific job payment by its UUID. Use when you need to archive a payment record.
- `SERVICEM8_LIST_ALL_ASSETS` — Tool to list all ServiceM8 assets. Use when you need a comprehensive asset registry, including custom fields, for inven…
- `SERVICEM8_LIST_ALL_CLIENTS` — Tool to list all ServiceM8 clients. Use when you need a complete set of customer records for integrations or reporting.
- `SERVICEM8_LIST_ALL_DOCUMENT_TEMPLATES` — Tool to list document templates. Use when you need to retrieve available template UUIDs and names before generating job…
- `SERVICEM8_LIST_ALL_FORMS` — Tool to list all ServiceM8 forms. Use when you need to fetch available form templates with optional filters.
- `SERVICEM8_LIST_ALL_JOB_NOTES` — Tool to list all job notes in ServiceM8. Use when you need to fetch notes, optionally filtered or paginated.
- `SERVICEM8_LIST_ALL_JOB_QUEUES` — Tool to list all job queues in ServiceM8. Use when you need to fetch configured queues before dispatching jobs.
- `SERVICEM8_LIST_ALL_JOBS` — Tool to list all jobs. Use when you need to fetch all job records from your ServiceM8 account.
- `SERVICEM8_LIST_ALL_LOCATIONS` — Tool to list all ServiceM8 locations. Use when you need to fetch every configured location for assignments or mapping.
- `SERVICEM8_LIST_ALL_MATERIALS` — Tool to list all materials. Use when you need a full inventory dump after authenticating with read_inventory scope.
- `SERVICEM8_LIST_ALL_TASKS` — Tool to list all tasks in a ServiceM8 account. Use when you need to fetch task records, optionally filtered. Requires '…
- `SERVICEM8_RETRIEVE_CLIENT` — Tool to retrieve details of a specific client by its UUID. Use after confirming the client's UUID is valid.
- `SERVICEM8_RETRIEVE_FORM` — Tool to retrieve details of a specific form by its UUID. Use when you need up-to-date form metadata given a known form …
- `SERVICEM8_RETRIEVE_JOB` — Tool to retrieve details of a specific job by its UUID. Use when you have the Job UUID and need its full record.
- `SERVICEM8_RETRIEVE_JOB_ACTIVITY` — Tool to retrieve details of a specific job activity by its UUID. Use when you have the job activity UUID and need its f…
- `SERVICEM8_RETRIEVE_JOB_NOTE` — Tool to retrieve details of a specific job note by its UUID. Use when you have the note UUID (e.g., after listing notes…
- `SERVICEM8_RETRIEVE_JOB_PAYMENT` — Tool to retrieve details of a specific job payment by its UUID. Use when you have the payment UUID and need its full re…
- `SERVICEM8_RETRIEVE_JOB_QUEUE` — Tool to retrieve details of a specific job queue by its UUID. Use when you need full queue metadata before dispatching …
- `SERVICEM8_RETRIEVE_LOCATION` — Tool to retrieve details of a specific location by its UUID. Use when you already have the location's UUID and need ful…
- `SERVICEM8_RETRIEVE_MATERIAL` — Tool to retrieve details of a specific material by its UUID. Use when you have a material UUID and need current invento…
- `SERVICEM8_RETRIEVE_STAFF_MEMBER` — Tool to retrieve details of a specific staff member by their UUID. Use when you need up-to-date staff information given…
- `SERVICEM8_SERVICE_M8_CREATE_JOB` — Tool to create a new job in ServiceM8. Use when you have all job details and need to push a record into ServiceM8. Exam…
- `SERVICEM8_UPDATE_JOB_NOTE` — Tool to update details of an existing job note. Use when modifying a note after its creation.
- `SERVICEM8_UPDATE_JOB_PAYMENT` — Tool to update details of an existing job payment. Use after confirming the payment UUID and desired changes.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get servicem8 <tool-name>
```
