ServiceTitan MCP Server

contacts_get_list

Retrieve and filter contact lists from ServiceTitan by criteria like name, creation/modification dates, and archive status. Supports sorting, pagination, and total count inclusion for efficient data management.

Input Schema

NameRequiredDescriptionDefault
createdBeforeNoFormat - date-time (as date-time in RFC3339). Return items created before certain date/time (in UTC)
createdOnOrAfterNoFormat - date-time (as date-time in RFC3339). Return items created on or after certain date/time (in UTC)
includeTotalNoWhether total count should be returned
isArchivedNoFilters by contact archive status
modifiedBeforeNoFormat - date-time (as date-time in RFC3339). Return items modified before certain date/time (in UTC)
modifiedOnOrAfterNoFormat - date-time (as date-time in RFC3339). Return items modified on or after certain date/time (in UTC)
nameNoFilters by contact name
pageNoFormat - int32. The logical number of page to return, starting from 1
pageSizeNoFormat - int32. How many records to return (50 by default)
referenceIdNoFilters by external reference ID
sortNoApplies sorting by the specified field: "?sort=+FieldName" for ascending order, "?sort=-FieldName" for descending order. Available fields are: Id, ModifiedOn, CreatedOn.
tenantYesFormat - int64. Tenant ID
titleNoFilters by contact title

Input Schema (JSON Schema)

{ "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "createdBefore": { "description": "Format - date-time (as date-time in RFC3339). Return items created before certain date/time (in UTC)", "type": [ "string", "null" ] }, "createdOnOrAfter": { "description": "Format - date-time (as date-time in RFC3339). Return items created on or after certain date/time (in UTC)", "type": [ "string", "null" ] }, "includeTotal": { "description": "Whether total count should be returned", "type": [ "boolean", "null" ] }, "isArchived": { "description": "Filters by contact archive status", "type": [ "string", "null" ] }, "modifiedBefore": { "description": "Format - date-time (as date-time in RFC3339). Return items modified before certain date/time (in UTC)", "type": [ "string", "null" ] }, "modifiedOnOrAfter": { "description": "Format - date-time (as date-time in RFC3339). Return items modified on or after certain date/time (in UTC)", "type": [ "string", "null" ] }, "name": { "description": "Filters by contact name", "type": [ "string", "null" ] }, "page": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "Format - int32. The logical number of page to return, starting from 1" }, "pageSize": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "Format - int32. How many records to return (50 by default)" }, "referenceId": { "description": "Filters by external reference ID", "type": [ "string", "null" ] }, "sort": { "description": "Applies sorting by the specified field:\n\"?sort=+FieldName\" for ascending order,\n\"?sort=-FieldName\" for descending order.\n\nAvailable fields are: Id, ModifiedOn, CreatedOn.", "type": [ "string", "null" ] }, "tenant": { "description": "Format - int64. Tenant ID", "type": "integer" }, "title": { "description": "Filters by contact title", "type": [ "string", "null" ] } }, "required": [ "tenant" ], "type": "object" }

You must be authenticated.

Other Tools from ServiceTitan MCP Server

Related Tools

ID: mrnu4dtu2r