ServiceTitan MCP Server

Complete Model Context Protocol (MCP) server for ServiceTitan field service management platform with 108 tools and 15 React apps.

Features

🔧 Tools (108 total)

Jobs Management (8 tools)

• servicetitan_list_jobs - List jobs with filters

• servicetitan_get_job - Get job details

• servicetitan_create_job - Create new job

• servicetitan_update_job - Update job details

• servicetitan_complete_job - Mark job complete

• servicetitan_cancel_job - Cancel a job

• servicetitan_list_job_appointments - List job appointments

• servicetitan_get_job_history - Get job history

Customers Management (9 tools)

• servicetitan_list_customers - List customers

• servicetitan_get_customer - Get customer details

• servicetitan_create_customer - Create new customer

• servicetitan_update_customer - Update customer

• servicetitan_deactivate_customer - Deactivate customer

• servicetitan_get_customer_balance - Get account balance

• servicetitan_list_customer_contacts - List customer contacts

• servicetitan_create_customer_contact - Create contact

• servicetitan_list_customer_locations - List customer locations

Estimates Management (8 tools)

• servicetitan_list_estimates - List estimates

• servicetitan_get_estimate - Get estimate details

• servicetitan_create_estimate - Create new estimate

• servicetitan_update_estimate - Update estimate

• servicetitan_mark_estimate_sold - Mark estimate as sold

• servicetitan_dismiss_estimate - Dismiss estimate

• servicetitan_get_estimate_items - Get estimate line items

• servicetitan_add_estimate_item - Add line item

Invoices & Payments (10 tools)

• servicetitan_list_invoices - List invoices

• servicetitan_get_invoice - Get invoice details

• servicetitan_create_invoice - Create new invoice

• servicetitan_update_invoice - Update invoice

• servicetitan_post_invoice - Post invoice

• servicetitan_void_invoice - Void invoice

• servicetitan_get_invoice_items - Get invoice items

• servicetitan_add_invoice_item - Add invoice item

• servicetitan_list_invoice_payments - List payments

• servicetitan_create_payment - Record payment

Dispatching (8 tools)

• servicetitan_list_appointments - List appointments

• servicetitan_get_appointment - Get appointment details

• servicetitan_create_appointment - Schedule appointment

• servicetitan_update_appointment - Update appointment

• servicetitan_assign_technician - Assign technician

• servicetitan_cancel_appointment - Cancel appointment

• servicetitan_list_dispatch_zones - List dispatch zones

• servicetitan_get_dispatch_board - Get dispatch board view

Technicians (8 tools)

• servicetitan_list_technicians - List technicians

• servicetitan_get_technician - Get technician details

• servicetitan_create_technician - Create technician

• servicetitan_update_technician - Update technician

• servicetitan_deactivate_technician - Deactivate technician

• servicetitan_get_technician_schedule - Get schedule

• servicetitan_get_technician_shifts - Get shifts

• servicetitan_create_technician_shift - Create shift

Equipment Management (6 tools)

• servicetitan_list_equipment - List equipment

• servicetitan_get_equipment - Get equipment details

• servicetitan_create_equipment - Register new equipment

• servicetitan_update_equipment - Update equipment

• servicetitan_deactivate_equipment - Deactivate equipment

• servicetitan_get_equipment_history - Get service history

Memberships (7 tools)

• servicetitan_list_memberships - List memberships

• servicetitan_get_membership - Get membership details

• servicetitan_create_membership - Create membership

• servicetitan_cancel_membership - Cancel membership

• servicetitan_renew_membership - Renew membership

• servicetitan_list_membership_types - List membership types

• servicetitan_get_membership_type - Get membership type

Inventory Management (7 tools)

• servicetitan_list_inventory_items - List inventory items

• servicetitan_get_inventory_item - Get item details

• servicetitan_create_inventory_item - Create item/SKU

• servicetitan_update_inventory_item - Update item

• servicetitan_deactivate_inventory_item - Deactivate item

• servicetitan_get_inventory_levels - Get stock levels

• servicetitan_adjust_inventory - Adjust stock

Locations (6 tools)

• servicetitan_list_locations - List locations

• servicetitan_get_location - Get location details

• servicetitan_create_location - Create service location

• servicetitan_update_location - Update location

• servicetitan_deactivate_location - Deactivate location

• servicetitan_list_location_equipment - List location equipment

Marketing & Leads (10 tools)

• servicetitan_list_campaigns - List campaigns

• servicetitan_get_campaign - Get campaign details

• servicetitan_create_campaign - Create campaign

• servicetitan_update_campaign - Update campaign

• servicetitan_list_leads - List leads

• servicetitan_get_lead - Get lead details

• servicetitan_create_lead - Create lead

• servicetitan_convert_lead - Convert lead to customer

• servicetitan_list_call_tracking - List call tracking

• servicetitan_get_lead_sources_report - Get lead sources report

Reporting & Analytics (9 tools)

• servicetitan_get_revenue_report - Revenue report

• servicetitan_get_technician_performance - Technician performance

• servicetitan_get_job_costing_report - Job costing report

• servicetitan_get_sales_report - Sales report

• servicetitan_get_customer_acquisition_report - Customer acquisition

• servicetitan_get_ar_aging_report - AR aging report

• servicetitan_get_membership_revenue_report - Membership revenue

• servicetitan_get_job_type_analysis - Job type analysis

• servicetitan_get_dispatch_metrics - Dispatch metrics

Tags (7 tools)

• servicetitan_list_tag_types - List tag types

• servicetitan_create_tag_type - Create tag type

• servicetitan_add_job_tag - Add job tag

• servicetitan_remove_job_tag - Remove job tag

• servicetitan_list_job_tags - List job tags

• servicetitan_add_customer_tag - Add customer tag

• servicetitan_remove_customer_tag - Remove customer tag

Payroll (5 tools)

• servicetitan_list_payroll_records - List payroll records

• servicetitan_get_technician_timesheet - Get timesheet

• servicetitan_get_technician_commissions - Get commissions

• servicetitan_get_payroll_summary - Get payroll summary

• servicetitan_export_payroll - Export payroll data

🎨 React Apps (15 total)

1. Job Board - View and manage all service jobs with filtering

2. Job Detail - Complete job information with appointments

3. Customer Dashboard - Manage customer accounts and activity

4. Customer Detail - Full customer profile with locations and contacts

5. Dispatch Board - Daily technician schedules and assignments

6. Estimate Builder - Create and track estimates and quotes

7. Invoice Dashboard - Manage invoices and track payments

8. Technician Schedule - View technician availability and shifts

9. Equipment Tracker - Monitor customer equipment and warranties

10. Membership Manager - Manage recurring service memberships

11. Marketing Dashboard - Track campaigns and lead generation

12. Inventory Manager - Track materials and stock levels

13. Payroll Overview - Track technician payroll and commissions

14. Reporting Dashboard - Financial reports and analytics

15. Location Map - Service locations directory

All apps feature:

• 🌑 Dark theme optimized for readability

• 📱 Responsive design

• ⚡ Real-time data via MCP tools

• 🎯 Intuitive filtering and search

Installation

cd /Users/jakeshore/.clawdbot/workspace/mcpengine-repo/servers/servicetitan
npm install
cd src/ui/react-app && npm install && cd ../../..

Configuration

Create a .env file:

SERVICETITAN_CLIENT_ID=your_client_id_here
SERVICETITAN_CLIENT_SECRET=your_client_secret_here
SERVICETITAN_TENANT_ID=your_tenant_id_here
SERVICETITAN_APP_KEY=your_app_key_here

Getting ServiceTitan API Credentials

1. Log into your ServiceTitan account

2. Go to Settings → Integrations → API Application Management

3. Create a new API application

4. Copy your Client ID, Client Secret, Tenant ID, and App Key

5. Configure OAuth2 scopes as needed

Build

npm run build

This will:

1. Compile TypeScript server code

2. Build all 15 React apps

3. Make the main entry point executable

Usage

As MCP Server

Add to your MCP client configuration:

{
  "mcpServers": {
    "servicetitan": {
      "command": "node",
      "args": ["/path/to/servers/servicetitan/dist/main.js"],
      "env": {
        "SERVICETITAN_CLIENT_ID": "your_client_id",
        "SERVICETITAN_CLIENT_SECRET": "your_client_secret",
        "SERVICETITAN_TENANT_ID": "your_tenant_id",
        "SERVICETITAN_APP_KEY": "your_app_key"
      }
    }
  }
}

Direct Usage

npm start

Development

# Watch TypeScript compilation
npm run watch

# Run in development mode
npm run dev

# Build React apps only
npm run build:apps

Architecture

servicetitan/
├── src/
│   ├── clients/
│   │   └── servicetitan.ts       # API client with OAuth2
│   ├── types/
│   │   └── index.ts               # TypeScript interfaces
│   ├── tools/                     # 14 tool modules
│   │   ├── jobs-tools.ts
│   │   ├── customers-tools.ts
│   │   ├── estimates-tools.ts
│   │   ├── invoices-tools.ts
│   │   ├── dispatching-tools.ts
│   │   ├── technicians-tools.ts
│   │   ├── equipment-tools.ts
│   │   ├── memberships-tools.ts
│   │   ├── inventory-tools.ts
│   │   ├── locations-tools.ts
│   │   ├── marketing-tools.ts
│   │   ├── reporting-tools.ts
│   │   ├── tags-tools.ts
│   │   └── payroll-tools.ts
│   ├── ui/
│   │   └── react-app/             # 15 React applications
│   │       └── src/
│   │           ├── apps/
│   │           ├── components/
│   │           ├── hooks/
│   │           └── styles/
│   ├── server.ts                  # MCP server setup
│   └── main.ts                    # Entry point
├── package.json
├── tsconfig.json
└── README.md

API Coverage

This MCP server covers all major ServiceTitan API v2 endpoints:

• ✅ Job Management (JPM)

• ✅ Customer Relationship Management (CRM)

• ✅ Sales & Estimates

• ✅ Accounting & Invoicing

• ✅ Dispatch & Scheduling

• ✅ Technician Management

• ✅ Equipment Tracking

• ✅ Memberships & Recurring Revenue

• ✅ Inventory & Materials

• ✅ Marketing & Lead Generation

• ✅ Reporting & Analytics

• ✅ Payroll & Commissions

• ✅ Settings & Configuration

License

MIT

Author

MCP Engine - BusyBee3333

Links

• ServiceTitan API Documentation

• MCP Specification

• GitHub Repository