field-service
ServiceM8 MCP, CLI, and Lua Integration for AI Agents
ServiceM8 integration docs for AI agents: MCP gateway setup, ServiceM8 CLI commands, Lua API reference, credentials, and function schemas.
7 functions 6 read 1 write Manual OAuth token auth
ServiceM8 for agents
Credentials can be configured manually in web or CLI hosts.
Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.
Machine-Readable Metadata
- integration_slug
service_m8- route_slug
service-m8- package
service-m8- auth_strategy
oauth2_manual_tokenManual OAuth token- cli_setup_supported
true- cli_runtime_supported
true- mcp_gateway_supported
true- lua_supported
true- supports_multi_account
true
Quick Links
Lua APIAgent-facing namespace and function reference. ServiceM8 CLIHeadless setup and direct function calls. ServiceM8 MCPMCP gateway setup for external clients. Submit feedbackReport missing tools, auth problems, wrong docs, or runtime issues. ContributeAdd tools or improve metadata in the integrations repo.
ServiceM8 MCP Client Matrix
Use these pages when a specific agent client or framework needs copy-pasteable MCP setup for ServiceM8.
Claude Code ServiceM8 MCP setup for Claude Code. Cursor ServiceM8 MCP setup for Cursor. Codex ServiceM8 MCP setup for Codex. OpenAI Agents ServiceM8 MCP setup for OpenAI Agents SDK. Claude Agent SDK ServiceM8 MCP setup for Claude Agent SDK. Vercel AI SDK ServiceM8 MCP setup for Vercel AI SDK. LangChain ServiceM8 MCP setup for LangChain. LangGraph ServiceM8 MCP setup for LangGraph. CrewAI ServiceM8 MCP setup for CrewAI. MCP clients ServiceM8 MCP setup for Generic MCP Clients.
ServiceM8 CLI Matrix
Use these pages for direct ServiceM8 CLI workflows in scripts, CI, cron, and agent wrappers.
CI ServiceM8 CLI for CI. Cron Jobs ServiceM8 CLI for cron jobs. Shell Scripts ServiceM8 CLI for shell scripts. Headless Automation ServiceM8 CLI for headless automation. Coding Agents ServiceM8 CLI for coding agents.
Function Catalog
| Function | Type | Parameters | Description |
|---|---|---|---|
service_m8.servicem8_list_jobs | Read read | 3 | List jobs from ServiceM8. Returns job details including status, client, dates, and descriptions. Supports filtering by status and pagination. |
service_m8.servicem8_get_job | Read read | 1 | Get detailed information about a specific ServiceM8 job by its UUID. Returns full job details including status, client, description, dates, and assigned staff. |
service_m8.servicem8_list_clients | Read read | 2 | List clients from ServiceM8. Returns client details including name, email, phone, and address. Supports pagination. |
service_m8.servicem8_get_client | Read read | 1 | Get detailed information about a specific ServiceM8 client by their UUID. Returns client details including name, email, phone, billing address, and notes. |
service_m8.servicem8_create_job | Write write | 3 | Create a new job in ServiceM8. Requires a client UUID. Optionally specify a job template and description to pre-populate the job. |
service_m8.servicem8_list_activities | Read read | 3 | List activity records from ServiceM8. Returns a timeline of events such as job status changes, comments, and notes. Supports filtering by job and pagination. |
service_m8.servicem8_get_current_user | Read read | 0 | Get the profile of the currently authenticated ServiceM8 user. Returns name, email, role, and account details. |