ServiceTitan MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ServiceTitan MCP Server list my customers with recently updated accounts"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ServiceTitan MCP Server
Connect Claude to ServiceTitan via API. 60 tools covering CRM, Jobs, Accounting, Estimates, Dispatch, Pricebook, Inventory, Memberships, Payroll, Marketing, Reporting, Timesheets, Telecom, and more.
Built for any ServiceTitan customer — each tenant manages its own credentials independently.
Quick Start
# Clone and install
git clone https://github.com/glassdoc/servicetitan-mcp.git
cd servicetitan-mcp
pip install -e .Related MCP server: ServiceTitan MCP Server
Configuration
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, or %APPDATA%\Claude\claude_desktop_config.json on Windows):
{
"mcpServers": {
"servicetitan": {
"command": "python",
"args": ["-m", "servicetitan_mcp.server"],
"env": {
"ST_APP_KEY": "your-app-key",
"ST_CLIENT_ID": "cid.your-client-id",
"ST_CLIENT_SECRET": "cs1.your-client-secret",
"ST_TENANT_ID": "your-tenant-id"
}
}
}
}For multiple tenants, add separate server entries (see claude_desktop_config_example.json).
Getting Your Credentials
Go to Settings > Integrations > API Application Access in your ServiceTitan tenant
Find the Claude MCP Integration app and click Connect
Fill in the restriction fields (booking_provider, gps_provider, report_category)
Accept Terms and Conditions
Copy your Client ID and generate a Client Secret
Your Tenant ID is shown in the top-right corner of any ServiceTitan page
The App Key is:
wj8g1SurukhS4
Available Tools (60)
CRM
list_customers— Search and list customersget_customer— Get customer details by IDlist_locations— List service locationsget_location— Get location detailslist_leads— List leads/opportunitieslist_bookings— List bookingslist_contacts— List customer contacts
Job Planning & Management
list_jobs— List jobs with filters (status, customer, date range)get_job— Get full job detailslist_appointments— List appointments by date rangelist_job_types— List configured job typeslist_projects— List projectsget_project— Get project details
Accounting
list_invoices— List invoices (filter by job, customer, date)get_invoice— Get invoice with line itemslist_payments— List payments receivedlist_payment_types— List payment typeslist_inventory_bills— List AP/inventory billslist_journal_entries— List journal entrieslist_payment_terms— List payment termslist_tax_zones— List tax zones
Sales & Estimates
list_estimates— List estimates (filter by job, status, sold date)get_estimate— Get estimate with line items
Dispatch
list_appointment_assignments— Technician-to-appointment assignmentslist_technician_shifts— Shift scheduleslist_zones— Dispatch zoneslist_non_job_appointments— Meetings, training, etc.
Pricebook
list_pricebook_services— Sellable serviceslist_pricebook_materials— Materialslist_pricebook_equipment— Equipmentlist_pricebook_categories— Categories
Inventory
list_purchase_orders— Purchase orderslist_warehouses— Warehouseslist_inventory_vendors— Vendors/supplierslist_trucks— Vehicle inventory
Memberships
list_memberships— Customer membershipslist_membership_types— Membership type definitionslist_recurring_services— Recurring services
Settings
list_employees— Employeesget_employee— Employee detailslist_technicians— Technicianslist_business_units— Business unitslist_tag_types— Tag typeslist_user_roles— User roles
Reporting
list_report_categories— Report categorieslist_reports_in_category— Reports in a categoryrun_report— Run a dynamic report
Payroll
list_payrolls— Payroll runslist_employee_payrolls— Employee payroll detailslist_gross_pay_items— Gross pay line items
Telecom
list_calls— Phone calls
Forms
list_forms— Form templateslist_form_submissions— Submitted forms
Marketing
list_campaigns— Marketing campaignslist_campaign_costs— Campaign costs
Equipment, Tasks, Timesheets
list_installed_equipment— Installed equipment at locationslist_tasks— Task management taskslist_activities— Timesheet activitieslist_activity_categories— Activity categories
Power User
servicetitan_api_call— Make any arbitrary API call (GET/POST/PATCH/PUT)
Authentication
Uses OAuth 2.0 Client Credentials flow. Tokens auto-refresh every 15 minutes. No user interaction required.
Rate Limits
Regular APIs: 60 calls/second per app per tenant
Reporting APIs: 5 requests/minute per report per tenant
License
MIT
Available Tools
60 toolsget_customerC
Get a single customer by ID.
Inputs: customer_id (required). Returns: result
get_employeeB
Get a single employee by ID.
Inputs: employee_id (required). Returns: result
get_estimateA
Get a single estimate by ID with line items.
Inputs: estimate_id (required). Returns: result
get_invoiceA
Get a single invoice by ID including line items.
Inputs: invoice_id (required). Returns: result
get_jobA
Get full details for a single job by ID.
Inputs: job_id (required). Returns: result
get_locationB
Get a single service location by ID.
Inputs: location_id (required). Returns: result
get_projectB
Get a single project by ID.
Inputs: project_id (required). Returns: result
list_activitiesC
List timesheet activities.
Inputs: page, page_size, starts_on_or_after. Returns: result
list_activity_categoriesC
List timesheet activity categories (Drive, Job, Break, etc.).
Inputs: page, page_size. Returns: result
list_appointment_assignmentsC
List dispatch appointment assignments (technician → appointment).
Inputs: page, page_size, starts_on_or_after, starts_on_or_before. Returns: result
list_appointmentsC
List appointments. Filter by date range (YYYY-MM-DD).
Inputs: page, page_size, starts_on_or_after, starts_on_or_before. Returns: result
list_bookingsC
List bookings. Optionally filter by status (Pending, Scheduled, etc.).
Inputs: page, page_size, status. Returns: result
list_business_unitsC
List business units.
Inputs: page, page_size. Returns: result
list_callsC
List phone calls. Filter by date range (YYYY-MM-DD).
Inputs: page, page_size, created_on_or_after, created_on_or_before. Returns: result
list_campaign_costsC
List marketing campaign costs.
Inputs: page, page_size, campaign_id. Returns: result
list_campaignsC
List marketing campaigns.
Inputs: page, page_size. Returns: result
list_contactsC
List customer contacts. Optionally filter by customer ID.
Inputs: page, page_size, customer_id. Returns: result
list_customersC
List customers. Optionally filter by name or active status.
Inputs: page, page_size, name, active_only. Returns: result
list_employee_payrollsC
List employee-level payroll details for a specific payroll run.
Inputs: payroll_id (required), page, page_size. Returns: result
list_employeesC
List employees. Optionally filter to active only.
Inputs: page, page_size, active_only. Returns: result
list_estimatesB
List estimates. Filter by job, status (Open, Sold, Dismissed), or sold date.
Inputs: page, page_size, job_id, status, +1 more. Returns: result
list_formsC
List form templates.
Inputs: page, page_size. Returns: result
list_form_submissionsD
List form submissions.
Inputs: page, page_size, created_on_or_after. Returns: result
list_gross_pay_itemsC
List gross pay line items for a payroll run.
Inputs: payroll_id (required), employee_id, page, page_size. Returns: result
list_installed_equipmentC
List installed equipment at customer locations.
Inputs: page, page_size, location_id. Returns: result
list_inventory_billsC
List AP / inventory bills.
Inputs: page, page_size, created_on_or_after. Returns: result
list_inventory_vendorsB
List inventory vendors/suppliers.
Inputs: page, page_size. Returns: result
list_invoicesC
List invoices. Filter by job, customer, or creation date.
Inputs: page, page_size, job_id, customer_id, +1 more. Returns: result
list_jobsC
List jobs. Filter by status, customer, or date range.
status examples: Scheduled, InProgress, Completed, Canceled Date format: YYYY-MM-DD
Inputs: page, page_size, status, customer_id, +2 more. Returns: result
list_job_typesB
List all job types configured in ServiceTitan.
Inputs: page, page_size. Returns: result
list_journal_entriesC
List journal entries.
Inputs: page, page_size, created_on_or_after. Returns: result
list_leadsC
List leads/opportunities. Optionally filter by status.
Inputs: page, page_size, status. Returns: result
list_locationsC
List service locations. Optionally filter by customer.
Inputs: page, page_size, customer_id. Returns: result
list_membershipsC
List customer memberships. Optionally filter by status (Active, Expired, Canceled).
Inputs: page, page_size, status. Returns: result
list_membership_typesC
List membership type definitions.
Inputs: page, page_size. Returns: result
list_non_job_appointmentsC
List non-job appointments (meetings, training, etc.).
Inputs: page, page_size, starts_on_or_after. Returns: result
list_paymentsC
List payments received.
Inputs: page, page_size, created_on_or_after. Returns: result
list_payment_termsC
List payment terms (Net 30, Due on Receipt, etc.).
Inputs: page, page_size. Returns: result
list_payment_typesC
List payment types (Cash, Check, Credit Card, etc.).
Inputs: page, page_size. Returns: result
list_payrollsC
List payroll runs.
Inputs: page, page_size. Returns: result
list_pricebook_categoriesC
List pricebook categories.
Inputs: page, page_size. Returns: result
list_pricebook_equipmentD
List pricebook equipment.
Inputs: page, page_size, active_only. Returns: result
list_pricebook_materialsC
List pricebook materials.
Inputs: page, page_size, active_only. Returns: result
list_pricebook_servicesC
List pricebook services (line items techs sell).
Inputs: page, page_size, active_only. Returns: result
list_projectsC
List projects. Optionally filter by status.
Inputs: page, page_size, status. Returns: result
list_purchase_ordersC
List purchase orders. Optionally filter by status.
Inputs: page, page_size, status. Returns: result
list_recurring_servicesC
List recurring services.
Inputs: page, page_size. Returns: result
list_report_categoriesA
List available report categories.
Inputs: no named parameters. Returns: result
list_reports_in_categoryC
List reports within a specific report category.
Inputs: category_id (required). Returns: result
list_tag_typesC
List tag types used for categorization.
Inputs: page, page_size. Returns: result
list_tasksC
List tasks in ServiceTitan task management.
Inputs: page, page_size. Returns: result
list_tax_zonesC
List tax zones.
Inputs: page, page_size. Returns: result
list_techniciansC
List technicians.
Inputs: page, page_size, active_only. Returns: result
list_technician_shiftsC
List technician shift schedules.
Inputs: page, page_size, starts_on_or_after, starts_on_or_before. Returns: result
list_trucksC
List trucks (vehicle inventory).
Inputs: page, page_size. Returns: result
list_user_rolesD
List user roles.
Inputs: page, page_size. Returns: result
list_warehousesD
List inventory warehouses.
Inputs: page, page_size. Returns: result
list_zonesC
List dispatch zones.
Inputs: page, page_size. Returns: result
run_reportB
Run a ServiceTitan report by ID.
parameters: JSON string of report parameters, e.g. '{"From":"2024-01-01","To":"2024-12-31"}'
Inputs: report_id (required), parameters, page, page_size. Returns: result
servicetitan_api_callA
Make an arbitrary ServiceTitan API call for advanced use.
method: GET, POST, PATCH, PUT path: Full path starting with / e.g. /crm/v2/tenant/{tenant_id}/customers Use {tenant_id} as a placeholder — it will be replaced automatically. query_params: JSON string of query parameters body: JSON string for request body (POST/PATCH/PUT)
Inputs: method (required), path (required), query_params, body. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 60 tools
Each tool targets a distinct entity and action (get_ vs list_). The diverse set of entities ensures no overlap. The generic servicetitan_api_call may overlap but is intended for advanced usage.
All tool names follow the consistent pattern of verb_entity (e.g., get_customer, list_estimates). No mixing of conventions, clear and predictable.
60 tools far exceeds the typical well-scoped range (3-15). While ServiceTitan has many entities, this many tools becomes heavy and may overwhelm agents.
The tool surface is almost entirely read-only (get/list). No create, update, or delete tools are provided for any entity, requiring agents to use the generic servicetitan_api_call for mutations, which is a significant gap.
Maintenance
Related MCP Connectors
Connect Claude and ChatGPT to QuoteIQ with 200+ tools for home service businesses.
Create contacts, move deals, send proposals and invoices, read your inbox, from Claude or ChatGPT.
One workspace of tools for Claude and ChatGPT: connect 600+ apps, generate media, build tools.
Connect Claude to Dutch accounting software: e-Boekhouden invoices, contacts and ledgers.
Related MCP Servers
- AlicenseCqualityDmaintenanceConnects Claude AI to Google Sheets, Gmail, and Calendar for comprehensive revenue tracking and business management. Enables lead pipeline management, email handling, calendar scheduling, task tracking, and file operations through natural language.29MIT
- AlicenseNot gradedqualityNot gradedmaintenanceProvides AI assistants with direct access to ServiceTitan's field service management platform for home services contractors. It enables users to manage customers, jobs, appointments, technician dispatching, and invoices through natural language.1MIT
- AlicenseAqualityFmaintenanceConnects Claude to Jobber to manage clients, jobs, invoices, quotes, and scheduling through natural language.10MIT
- AlicenseCqualityDmaintenanceConnects Claude AI to Google Sheets for automated revenue tracking, lead management, and business operations, with Gmail and calendar integration.13MIT