Skip to main content
Glama
ServiceTitan MCP Server

ServiceTitan MCP Server

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

  1. Go to Settings > Integrations > API Application Access in your ServiceTitan tenant

  2. Find the Claude MCP Integration app and click Connect

  3. Fill in the restriction fields (booking_provider, gps_provider, report_category)

  4. Accept Terms and Conditions

  5. Copy your Client ID and generate a Client Secret

  6. Your Tenant ID is shown in the top-right corner of any ServiceTitan page

  7. The App Key is: wj8g1SurukhS4

Available Tools (60)

CRM

  • list_customers — Search and list customers

  • get_customer — Get customer details by ID

  • list_locations — List service locations

  • get_location — Get location details

  • list_leads — List leads/opportunities

  • list_bookings — List bookings

  • list_contacts — List customer contacts

Job Planning & Management

  • list_jobs — List jobs with filters (status, customer, date range)

  • get_job — Get full job details

  • list_appointments — List appointments by date range

  • list_job_types — List configured job types

  • list_projects — List projects

  • get_project — Get project details

Accounting

  • list_invoices — List invoices (filter by job, customer, date)

  • get_invoice — Get invoice with line items

  • list_payments — List payments received

  • list_payment_types — List payment types

  • list_inventory_bills — List AP/inventory bills

  • list_journal_entries — List journal entries

  • list_payment_terms — List payment terms

  • list_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 assignments

  • list_technician_shifts — Shift schedules

  • list_zones — Dispatch zones

  • list_non_job_appointments — Meetings, training, etc.

Pricebook

  • list_pricebook_services — Sellable services

  • list_pricebook_materials — Materials

  • list_pricebook_equipment — Equipment

  • list_pricebook_categories — Categories

Inventory

  • list_purchase_orders — Purchase orders

  • list_warehouses — Warehouses

  • list_inventory_vendors — Vendors/suppliers

  • list_trucks — Vehicle inventory

Memberships

  • list_memberships — Customer memberships

  • list_membership_types — Membership type definitions

  • list_recurring_services — Recurring services

Settings

  • list_employees — Employees

  • get_employee — Employee details

  • list_technicians — Technicians

  • list_business_units — Business units

  • list_tag_types — Tag types

  • list_user_roles — User roles

Reporting

  • list_report_categories — Report categories

  • list_reports_in_category — Reports in a category

  • run_report — Run a dynamic report

Payroll

  • list_payrolls — Payroll runs

  • list_employee_payrolls — Employee payroll details

  • list_gross_pay_items — Gross pay line items

Telecom

  • list_calls — Phone calls

Forms

  • list_forms — Form templates

  • list_form_submissions — Submitted forms

Marketing

  • list_campaigns — Marketing campaigns

  • list_campaign_costs — Campaign costs

Equipment, Tasks, Timesheets

  • list_installed_equipment — Installed equipment at locations

  • list_tasks — Task management tasks

  • list_activities — Timesheet activities

  • list_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 tools
get_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

    C2.6/5.0

    Scored across 60 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    All tool names follow the consistent pattern of verb_entity (e.g., get_customer, list_estimates). No mixing of conventions, clear and predictable.

    Tool Count2/5

    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.

    Completeness2/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers