Click on "Install 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 ServerFind customer John Miller and list his unpaid invoices."
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
AI-native interface to ServiceTitan for home services contractors
An MCP (Model Context Protocol) server that gives AI assistants direct access to ServiceTitan — the leading field service management platform. Built for HVAC, plumbing, electrical, and other home services contractors who want their AI to manage jobs, look up customers, schedule appointments, dispatch technicians, and track invoices.
🛠️ Available Tools
Tool | Description |
| Search customers by name, phone, email, or address |
| Get full customer details including contacts and service history |
| List jobs with filters for status, date range, customer, or technician |
| Get complete job details including notes and assigned tech |
| Create a new job for a customer |
| Find available appointment slots in a date range |
| Schedule or reschedule a job appointment |
| List active technicians with current status and schedule |
| Assign a technician to a job appointment |
| Get invoice details with line items and payment status |
| List unpaid/overdue invoices for collections follow-up |
🚀 Quick Start
1. Get ServiceTitan API Credentials
Go to the ServiceTitan Developer Portal
Create an application in My Apps to get your App Key
Have your ServiceTitan admin generate Client ID and Client Secret for your environment
Note your Tenant ID from ServiceTitan settings
2. Configure Environment
3. Install & Run
4. Connect to Your AI
Add to your MCP client configuration (e.g., Claude Desktop):
🔐 Authentication
ServiceTitan uses OAuth2 Client Credentials grant:
Auth endpoint:
https://auth.servicetitan.io/connect/token(production) orhttps://auth-integration.servicetitan.io/connect/token(sandbox)API base:
https://api.servicetitan.io(production) orhttps://api-integration.servicetitan.io(sandbox)Required headers:
Authorization: Bearer {token}+ST-App-Key: {app_key}Tokens are cached and auto-refreshed before expiry
Required Environment Variables
Variable | Description |
| OAuth2 Client ID |
| OAuth2 Client Secret |
| ServiceTitan Application Key |
| Your ServiceTitan Tenant ID |
|
|
📦 ServiceTitan API Modules Used
Module | Base Path | Entities |
CRM |
| Customers, Contacts, Locations, Bookings |
Job Planning |
| Jobs, Appointments, Job Types |
Dispatch |
| Technician Shifts, Appointment Assignments |
Accounting |
| Invoices, Payments |
Settings |
| Technicians, Employees, Business Units |
🧪 Development
☁️ Deployment
Apify Marketplace
Coming Day 3 — pay-per-event billing on Apify
The apify_actor/ directory contains the deployment scaffold for the Apify platform.
mcp.so
Coming — listing at mcp.so
Smithery
Coming — listing at smithery.ai
📋 Roadmap
Day 1: Core scaffold — 11 tools covering the contractor workflow loop
Day 2: Validate against ServiceTitan sandbox, fix endpoint paths, add integration tests
Day 3: Apify Actor deployment, pay-per-event billing, marketplace listings
📄 License
MIT