Tools

Create Client

Create a new client (company) in ServiceM8. The name is required. Optionally provide address, website, and billing details. Returns the UUID of the newly created client.

List Job Activities

List scheduled bookings and recorded time entries (job activities) from ServiceM8. Filter by job UUID, staff UUID, or date range to find specific schedule entries.

Schedule Job

Create a scheduled booking (job activity) for a job and optionally assign a staff member. This creates a time-based entry on the schedule with start and end times. Use this to schedule work periods and allocate staff.

List Jobs

List and filter jobs from ServiceM8. Supports OData-style filtering on fields like **status**, **company_uuid**, **active**, and **total_price**. Returns all matching jobs with their details including status, address, description, and pricing.

Delete Job

Delete a job from ServiceM8 by UUID. This marks the job as inactive/deleted.

Get Client

Retrieve a single client (company) by UUID, including their address, contact details, and associated contacts.

Manage Contact

Create or update a company contact in ServiceM8. If a contactUuid is provided, the existing contact is updated. Otherwise, a new contact is created linked to the specified company.

Update Job

Update an existing job in ServiceM8. Modify any combination of fields including status, description, address, pricing, and client association. Only the provided fields will be updated.

Create Job

Create a new job in ServiceM8. Specify the job address, description, status, and optionally link it to a client (company). Returns the UUID of the newly created job.

Get Job

Retrieve a single job by UUID with all its details including status, address, description, pricing, and associated client information.

List Clients

List and filter clients (companies) from ServiceM8. Supports OData-style filtering on fields like **name**, **active**, **address_city**, etc. Returns all matching client records.

Manage Job Materials

List, add, update, or remove materials (line items) on a job. Use **action** to specify the operation: `list` returns all materials for a job, `add` creates a new line item, `update` modifies an existing one, and `remove` deletes it.

Update Client

Update an existing client (company) in ServiceM8. Modify any combination of fields including name, address, website, and billing details. Only the provided fields will be updated.

List Staff

List staff members in ServiceM8. Supports OData-style filtering on fields like **active**. Returns all matching staff records with names, email, and mobile.

Add Note

Add a note to a job or other record in ServiceM8. Notes appear in the job diary and can include text content linked to a specific job by UUID.

Record Payment

Record a payment against a job in ServiceM8. Specify the job, payment amount, and optionally the payment method. Returns the UUID of the created payment record.