DeepLedger
Menu

Bookkeeping

Connect ServiceTitan to Your AI Agent With QuickBooks or Xero

An AI agent can read your ServiceTitan jobs, invoices, payments and purchase orders next to the books in QuickBooks or Xero. The setup, what it reads, and how to tie field work to the ledger.

Published by DeepLedger11 min read

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.

AreaRecordsUseful filters
CustomersCustomers and their service locationsName, active or inactive, created and modified days
JobsJobs and appointmentsJob status, completed date, appointment start date, customer, location
AccountingInvoices, payments received, inventory (vendor) bills, GL accountsInvoice date, paid date, customer, job; inventory bills and GL accounts by id
PurchasingPurchase orders, inventory receipts, vendorsPurchase order status, job, active vendors; receipts by id
Accounting exportServiceTitan's export feeds of invoices, payments and inventory billsChanges since a day, then page by page
Connection checkWhich areas your app can read, and which need a read scopeNone

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

  1. 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.
  2. 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 readRead scope in the developer portal
Customers and locationsCRM: Customers (required to connect), CRM: Locations
Jobs and appointmentsJob Planning and Management: Jobs, Appointments
Invoices, payments, inventory bills, GL accountsAccounting: Invoices, Payments, Inventory Bills, GL Accounts
Purchase orders, receipts, vendorsInventory: Purchase Orders, Receipts, Vendors
Accounting export feedsAccounting: 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

  1. 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

  1. 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

  1. 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

  1. 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 seeWhat to do
ServiceTitan refused the client id or secretGenerate 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 appCheck 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 withAdd 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 missingAdd that area's read scope to your app in the developer portal, then run the connection check again.
The tenant does not matchCheck the tenant id on the Connections tab against the one in API Application Access.
The AI agent says it has no ServiceTitan toolDeepLedger 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 businessAsk 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:

See every supported app on AI platforms and integrations.

Ready to get started?

Connect QuickBooks and try your first task with an AI agent.

Create an Account

With your permission, Google Analytics measures visits to our public website and blog. Essential cookies work either way. Change your choice in Cookie settings. Privacy policy