Productivity

ServiceM8

Read-only bounded servicem8 workflow evidence for OrgSDK.

Explore 7 capabilities ↓

What you can build

Review job and diary evidence for one ServiceM8 account
Compare job progress with the agreed work scope

Access and credentials

Read-only evidence retrieval, constrained by mandatory configured resource boundaries. No external writes.

This plugin uses an API token. Store credentials in OrgSDK and select them for the project that needs access.

Example action

Verify the configured ServiceM8 account

Use this call in a saved OrgSDK action after enabling the plugin and connecting a credential.

return await servicem8.getAccount({});

Use with OrgSDK

OrgSDK gives external AI clients persistent projects and controlled execution. Plugins add optional tools to those projects. Each run uses pinned plugin versions, and project configuration determines which credentials they can use.

Set up OrgSDK locally ↗

The plugin’s toolkit

Capabilities

7 functions from this published version. Read calls retrieve or process information; write actions can change data in the connected service.

Find a function

7 of 7 functions

`servicem8.getAccount`

Read call

Verify API key and expected account; return account identity and key access level.

Parameters and return value

This call takes no parameters.

Returns Promise<{ account: { uuid: string; name?: string }; key: { access_level: string; auth_method?: string } }>

`servicem8.listJobs`

Read call

Read one ServiceM8 cursor page of active jobs; defaults to Completed for invoice evidence.

Parameters and return value

Parameter	Type	Details
`status`Optional	`"Completed" \| "Quote" \| "Work Order" \| "Unsuccessful"`	—
`cursor`Optional	`string`	—
`modifiedSince`Optional	`string`	—

Returns Promise<{ records: Record<string, unknown>[]; nextCursor: string | null }>

`servicem8.getJob`

Read call

Read job scope, work done, completion and invoice fields. Web link requires ServiceM8 sign-in.

Parameters and return value

Parameter	Type	Details
`jobId`	`string`	—

Returns Promise<Record<string, unknown>>

`servicem8.listClients`

Read call

Read one cursor page of active clients in the verified account.

Parameters and return value

Parameter	Type	Details
`cursor`Optional	`string`	—

Returns Promise<{ records: Record<string, unknown>[]; nextCursor: string | null }>

`servicem8.getClient`

Read call

Read selected client and billing metadata in the verified account.

Parameters and return value

Parameter	Type	Details
`clientId`	`string`	—

Returns Promise<Record<string, unknown>>

`servicem8.listJobAttachments`

Read call

Read one page of job-related attachment metadata, including quote or invoice source labels.

Parameters and return value

Parameter	Type	Details
`jobId`	`string`	—
`cursor`Optional	`string`	—

Returns Promise<{ records: Record<string, unknown>[]; nextCursor: string | null }>

`servicem8.getJobAttachment`

Read call

Read attachment metadata only after checking it belongs to the requested job.

Parameters and return value

Parameter	Type	Details
`jobId`	`string`	—
`attachmentId`	`string`	—

Returns Promise<Record<string, unknown>>