You connect ServiceTitan to an AI agent through DeepLedger: your ServiceTitan admin creates a read-only app in ServiceTitan's developer portal, a DeepLedger owner or admin enters its credentials on the company's Connections tab, and your AI app reaches it at https://mcp.deepledger.ai/mcp. The AI agent can then read jobs, invoices, payments, purchase orders and vendors in ServiceTitan next to the company's books in QuickBooks or Xero. It cannot change anything in ServiceTitan.
This guide is for accounting firms, bookkeepers and controllers who close the books for HVAC, plumbing, electrical and other field service businesses that run on ServiceTitan. It covers what the AI agent reads, the setup on both sides, prompts that tie field work to the ledger, and the limits to know before you start.
DeepLedger is an independent integration. It is not affiliated with or endorsed by ServiceTitan.
What the AI agent can read in ServiceTitan
DeepLedger gives the AI agent six read-only ServiceTitan tools. Each one reads your company's own tenant with your company's own app.
| Area | Records | Useful filters |
|---|---|---|
| Customers | Customers and their service locations | Name, active or inactive, created and modified days |
| Jobs | Jobs and appointments | Job status, completed date, appointment start date, customer, location |
| Accounting | Invoices, payments received, inventory (vendor) bills, GL accounts | Invoice date, paid date, customer, job; inventory bills and GL accounts by id |
| Purchasing | Purchase orders, inventory receipts, vendors | Purchase order status, job, active vendors; receipts by id |
| Accounting export | ServiceTitan's export feeds of invoices, payments and inventory bills | Changes since a day, then page by page |
| Connection check | Which areas your app can read, and which need a read scope | None |
A filter that does not apply to a record type is refused before anything is sent, never dropped. Days are UTC, and a date range includes both its first and last day.
What it cannot do
- Change ServiceTitan. Every ServiceTitan tool is a read. DeepLedger sends ServiceTitan only read requests, plus its own sign-in, to a fixed list of paths with your own tenant id, and refuses any other request before it is sent.
- Choose what to call. There is no free-form endpoint or parameter. The AI agent picks a tool and its filters; DeepLedger builds the request.
- Keep your data. Each call reads, answers and keeps no ServiceTitan records. Fields that hold bank account numbers, card numbers or tax ids are left out of every answer.
- Run ServiceTitan reports. ServiceTitan's reporting API runs reports through a request DeepLedger does not send, so reports are not offered. The accounting export feeds are.
Before you start
- A ServiceTitan plan that lets you build your own app. ServiceTitan's help center says customer-built apps need The Works or Enterprise Plus package (as of November 2026).
- ServiceTitan's permission for this connection. ServiceTitan's API terms limit sharing an app's credentials with another company and using ServiceTitan data with AI. Check that ServiceTitan allows this connection for your account before you connect.
- A ServiceTitan admin who can create an app in ServiceTitan's developer portal and connect it to your tenant.
- A DeepLedger account with the company set up, usually with QuickBooks Online or Xero already connected. The trial needs no card.
- An owner or admin in DeepLedger, to enter the ServiceTitan credentials.
- An AI app that supports custom MCP connectors: Claude, ChatGPT, Gemini, Grok, Microsoft Copilot Studio, Cursor, or your own agent.
How do I connect ServiceTitan to an AI agent?
Step 1: Create a read-only app in ServiceTitan
- Create the app. A ServiceTitan admin creates an application in ServiceTitan's developer portal and gives it read scopes only, then copies its app key.
- Give it the CRM: Customers read scope, which DeepLedger needs to connect, plus read access to each other area you want the AI agent to read. No write scope is needed or used.
| To read | Read scope in the developer portal |
|---|---|
| Customers and locations | CRM: Customers (required to connect), CRM: Locations |
| Jobs and appointments | Job Planning and Management: Jobs, Appointments |
| Invoices, payments, inventory bills, GL accounts | Accounting: Invoices, Payments, Inventory Bills, GL Accounts |
| Purchase orders, receipts, vendors | Inventory: Purchase Orders, Receipts, Vendors |
| Accounting export feeds | Accounting: Export (invoices, payments, inventory bills) |
DeepLedger checks the app by reading one customer when you connect, so it refuses the connection without CRM: Customers. Every other read scope is optional: an area without one is reported as missing when the AI agent reads it.
Step 2: Connect the app to your tenant
- Connect the app to your tenant. In ServiceTitan, open Settings, then Integrations, then API Application Access, connect the app, and generate its client id and client secret. Note the tenant id shown there.
Step 3: Enter the credentials in DeepLedger
- Enter the values in DeepLedger. A DeepLedger owner or admin opens Companies, chooses the company, then Connections, then ServiceTitan, and enters the client id, client secret, app key and tenant id.
DeepLedger encrypts the credentials and ties them to that one company. They are never shown again, never logged and never sent to the AI agent. DeepLedger reads your ServiceTitan production environment.
Step 4: Add DeepLedger to your AI app
- Add the connector once. In your AI app, add https://mcp.deepledger.ai/mcp as a custom connector and sign in with your DeepLedger account. If you already use DeepLedger for QuickBooks or Xero, skip this step.
Sign in with your DeepLedger account when asked, never your ServiceTitan login.
- ChatGPT: go to chatgpt.com/plugins, select +, then Add custom MCP server, enter the address and choose OAuth. Switching between companies needs a ChatGPT Business, Enterprise or Edu workspace (as of November 2026). Full steps: connect ChatGPT to Xero.
- Gemini: on the web, open Settings, then Connected Apps, and add a custom app with the address. The steps match the Gemini guide for Xero.
- Grok: open grok.com/connectors, choose New Connector, then Custom, and paste the address. The steps match the Grok guide for Xero.
- Microsoft Copilot Studio: add a Model Context Protocol tool with the address and a personal DeepLedger API key. Create the key for All my companies so the agent can switch. The steps match the Copilot guide for Xero.
- Cursor and your own agents: any client that supports remote MCP servers with OAuth can use the same address.
Step 5: Check the connection
- Check the connection. Ask: Using DeepLedger, which company am I in? Check the ServiceTitan connection and list which areas it can read.
The connection check reads one record from each area and reports which ones answered, which need a read scope added to your app, and which did not answer for another reason. Fix any missing scope in the developer portal before you rely on an answer. The check does not cover the export feeds; a missing Export scope shows on the first export read.
How do I tie ServiceTitan to QuickBooks or Xero?
Many field service businesses send invoices and payments from ServiceTitan to the books with an integration. The copies still drift: an invoice adjusted after it synced, a payment posted twice, a job finished but never invoiced, a vendor bill entered by hand. The AI agent reads both sides and lists the differences. Start each prompt with "do not change anything" and name the company.
1. Invoices against revenue
In Summit Air Services, do not change anything. List ServiceTitan invoices dated in October 2026 with customer, job, invoice date and total. Then list invoices in the books for October 2026. Match them by invoice number, or by customer and amount, and show invoices on one side only and invoices whose totals differ.
2. Payments against deposits
List ServiceTitan payments with a paid date in October 2026, totalled by day. Compare each day's total with the deposits in the books for the same days, and list any day that does not match.
Card and check payments often reach the bank as one deposit for several payments. If the books hold them in Undeposited Funds first, ask the AI agent to compare against that account too.
3. Completed jobs with no invoice
List ServiceTitan jobs completed between October 1 and October 31, 2026. For each one, list its invoices. Show completed jobs with no invoice, with customer and completion date.
4. Purchase orders and vendor bills
List ServiceTitan purchase orders created in October 2026 with vendor, job and status. Read the inventory bills export feed for changes since October 1, 2026. Compare both with the bills in the books, and list purchase orders with no bill and vendor bills on one side only.
5. What changed since the last close
Read the ServiceTitan invoices export feed for changes since November 1, 2026. List the invoices dated in October 2026 that appear in it, and compare each total with the same invoice in the books.
6. Turn the differences into tasks
Summarize every difference you found in one table: customer or vendor, side, document, amount and the likely cause. Create a task for each one that needs a person to decide.
The tasks appear in DeepLedger for a reviewer to work through. Fix each difference where it belongs: in ServiceTitan, in the ledger, or in the sync. For the full close, see the QuickBooks month-end close checklist or the Xero month-end close checklist.
Limits worth knowing
- Read only. Changes are made in ServiceTitan or the ledger by a person, never by the AI agent through ServiceTitan.
- One tenant per company. Each DeepLedger company connects to its own ServiceTitan tenant with its own app.
- Your app's scopes decide what is readable. A missing read scope is reported as missing, never as an empty list.
- No reports. ServiceTitan's own reports are not offered; build the comparison from records or the export feeds.
- Rate limits. If ServiceTitan asks DeepLedger to slow down for longer than a short wait, the AI agent says so and when to try again. Nothing is marked as broken.
Is it safe?
- Each person signs in as themselves. Members reach only the companies they are assigned to; owners and admins see every company.
- Your app, your scopes. DeepLedger can read only what your ServiceTitan app's read scopes allow.
- Revoking access. Disconnect ServiceTitan on the company's Connections tab and the ServiceTitan tools stop at once. Remove the connector in your AI app to stop DeepLedger everywhere.
Troubleshooting
| What you see | What to do |
|---|---|
| ServiceTitan refused the client id or secret | Generate a new client id and secret in ServiceTitan's API Application Access and enter them again on the company's Connections tab. |
| ServiceTitan refused the app | Check the app key, and that the app is still connected to your tenant. |
| Connecting says the app doesn't have the read access DeepLedger checks with | Add the CRM: Customers read scope to your app in the developer portal, reconnect the app in the tenant's API Application Access, then connect again on the Connections tab. |
| A read scope is missing | Add that area's read scope to your app in the developer portal, then run the connection check again. |
| The tenant does not match | Check the tenant id on the Connections tab against the one in API Application Access. |
| The AI agent says it has no ServiceTitan tool | DeepLedger offers the ServiceTitan tools when you ask for ServiceTitan data. Ask: Using DeepLedger, list this company's connections, then read ServiceTitan jobs. If ServiceTitan is not connected, check the company's Connections tab. |
| The answer shows the wrong business | Ask which company is active and switch. See one sign-in, every company. |
Frequently asked questions
Can an AI agent read ServiceTitan?
Yes. Through DeepLedger, an AI agent reads a company's ServiceTitan customers, locations, jobs, appointments, invoices, payments, inventory bills, GL accounts, purchase orders, receipts and vendors, plus the accounting export feeds. It reads them in the same conversation as the company's QuickBooks or Xero books.
Can the AI agent change anything in ServiceTitan?
No. The ServiceTitan connection is read only. DeepLedger sends ServiceTitan only read requests, plus its own sign-in, to a fixed list of paths, and refuses anything else before it leaves DeepLedger, so the AI agent cannot create, edit or delete a job, invoice or payment.
What do I need from ServiceTitan to connect it?
Your company's own app from ServiceTitan's developer portal, with read scopes only: its client id, client secret and app key, and your tenant id. A ServiceTitan admin creates the app and connects it to the tenant; a DeepLedger owner or admin enters the values on the company's Connections tab.
Does DeepLedger store my ServiceTitan data?
No. Each call reads from ServiceTitan, answers and keeps no ServiceTitan records. Fields that hold bank account numbers, card numbers or tax ids are left out of every answer. DeepLedger keeps only the saved connection, encrypted.
Does this replace ServiceTitan's QuickBooks integration?
No. DeepLedger does not sync anything into the books. Keep the sync you use today; the AI agent reads ServiceTitan and the ledger side by side and lists where they disagree, for a person to review.
Connect from your AI app
Step-by-step guides for adding DeepLedger and reading ServiceTitan in each app:
- Connect ServiceTitan to ChatGPT
- Connect ServiceTitan to Claude
- Connect ServiceTitan to Gemini
- Connect ServiceTitan to Microsoft Copilot Studio and Teams
- Connect ServiceTitan to Grok
- Connect ServiceTitan to Grok Bot
- Connect ServiceTitan to Cursor
Related guides
- Connect Housecall Pro to your AI agent
- QuickBooks MCP server guide
- Xero MCP server guide
- Reconcile Stripe payouts in QuickBooks or Xero with AI
See every supported app on AI platforms and integrations.