You connect ServiceTitan to Grok through DeepLedger: connect ServiceTitan once to the company in DeepLedger with your own read-only ServiceTitan app, then add https://mcp.deepledger.ai/mcp as a custom connector at grok.com/connectors. Grok can then read ServiceTitan jobs, invoices, payments, purchase orders and vendors next to the company's QuickBooks Online or Xero books. Developers can reach the same reads from the xAI Responses API.
This guide covers the Grok chat connector, the admin step on Grok Business and Enterprise, and an API request that can only read. Grok Bot, xAI's agent on a cloud computer, has its own setup: see Connect ServiceTitan to Grok Bot.
DeepLedger is an independent integration. It is not affiliated with or endorsed by ServiceTitan or xAI.
Three routes from Grok to ServiceTitan
| Route | Who it is for | How it signs in to DeepLedger |
|---|---|---|
| Grok custom connector | Anyone using Grok chat on the web or in the app | Your DeepLedger sign-in |
| Grok Business or Enterprise | Teams, after an admin adds the connector | Each member's own sign-in |
| xAI Responses API | Scripts and agents your developers run | A DeepLedger API key |
All three reach the same DeepLedger tools. ServiceTitan is read only on every route.
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 DeepLedger account with the company's QuickBooks Online or Xero books connected. The trial needs no card.
- For Grok chat: the Custom option at grok.com/connectors. xAI says connectors are available to all Grok users, and its connector documentation is the reference for current availability.
- For the API: an xAI API key and a DeepLedger API key.
Connect ServiceTitan to the company in DeepLedger
Grok never holds the ServiceTitan credentials. They are saved once per company in DeepLedger:
- A ServiceTitan admin creates an app in ServiceTitan's developer portal with read scopes only; CRM: Customers is required to connect.
- The admin connects the app to your tenant under Settings → Integrations → API Application Access and generates the client id and client secret.
- A DeepLedger owner or admin enters the client id, client secret, app key and tenant id under Companies, the company, Connections, ServiceTitan.
The scopes for each area, and what each refusal means, are in Connect ServiceTitan to your AI agent.
How do I connect ServiceTitan to Grok?
If DeepLedger is already a connector in your Grok account, for example from the Grok and QuickBooks Online guide, skip to the check in step 4.
- Open connectors. Open grok.com/connectors while signed in to Grok.
- Add a custom connector. Choose New Connector, then Custom, and paste
https://mcp.deepledger.ai/mcp. - Sign in to DeepLedger. Sign in with your DeepLedger account when Grok sends you to the sign-in page, never your ServiceTitan login.
- Check the connection. Start a new conversation and ask which company you are in and whether ServiceTitan is connected.
Which company am I in? Check the ServiceTitan connection and list which areas it can read.
xAI says Grok discovers the tools a server exposes once the connector is added. ServiceTitan's tools may not be among them by name: Grok reaches them through DeepLedger's connections, describeTool and callReadTool, all read only.
Grok Business and Enterprise: a team admin first adds the connector in the xAI console. Log in at console.x.ai, choose the team, open Grok Business → Connectors, select Add Connector, then Other, and enter the same address. Members then connect their own accounts at grok.com/connectors. See xAI's connector management guide.
Prompts for field service bookkeeping in Grok
Start with the company name and the period. Read the company name in each answer before you rely on a figure.
Revenue tie-out
In Summit Ridge Plumbing, compare the total of ServiceTitan invoices dated October 2026 with October 2026 income in the books. If they differ, list the invoices on one side only and the invoices whose totals differ.
Unbilled work
List ServiceTitan jobs completed in October 2026 that have no invoice, with customer, location and completion date.
Collections check
List ServiceTitan payments received from October 1 to October 31, 2026 for Summit Ridge Plumbing's five largest customers, and compare each customer's total with the payments recorded in the books.
Changes since the close
Read the ServiceTitan payments export feed for changes since November 1, 2026. List payments with a paid date in October 2026 that appear in it, and check each one against the books.
A second company
Switch to Summit Ridge Electric and run the same revenue tie-out for October 2026.
When a difference needs a decision, ask Grok to create a DeepLedger task for it. A reviewer works through the tasks in DeepLedger and corrects each difference in ServiceTitan, the ledger or the sync.
Using the xAI API for a ServiceTitan job
For a script or agent you run yourself, add DeepLedger as a remote MCP tool. Create a DeepLedger API key under Settings → API keys → Create key. For a job that must stay in one client, choose One company, so the key cannot switch. Keep the key in an environment variable.
curl https://api.x.ai/v1/responses \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-4.7",
"input": [{"role": "user", "content": "Using ServiceTitan, list jobs completed in October 2026 with no invoice. Then compare October ServiceTitan invoice totals with October income in the books."}],
"tools": [{
"type": "mcp",
"server_url": "https://mcp.deepledger.ai/mcp",
"server_label": "deepledger",
"authorization": "'"$DEEPLEDGER_API_KEY"'",
"allowed_tools": ["connections", "describeTool", "callReadTool"]
}]
}'
Why those three tools:
- xAI does not support
require_approvalin the Responses API, so nothing asks before a tool runs. Limitingallowed_toolsto reads keeps the job to reads. callReadToolruns reads only, in ServiceTitan and in the books, and refuses any call that would change data.connectionsanddescribeToolare read only too.companiesis left out because it can switch your active company, which every AI app you use with DeepLedger shares. With a One company key the job reads that company without it.
allowed_tools limits what this request offers the model; it is not a permission on the key. The key still acts as the person who created it. Field names and the model name follow xAI's remote MCP documentation; use a current model from xAI's docs.
Is it safe to connect ServiceTitan to Grok?
- Read only toward ServiceTitan. DeepLedger sends ServiceTitan only read requests, plus its own sign-in, to a fixed list of paths, and refuses any other request before it is sent.
- No ServiceTitan data kept by DeepLedger. Each call reads, answers and keeps nothing; bank account, card and tax id fields are left out of every answer.
- Per-person access. Each person reaches only their assigned companies; read-only members in DeepLedger cannot write to the books from any app.
- Revoking access. Remove the connector at grok.com/connectors, revoke the grant under Settings → Connected apps or the key under Settings → API keys in DeepLedger, or disconnect ServiceTitan on the company's Connections tab.
Troubleshooting
No Custom option at grok.com/connectors. On Grok Business and Enterprise, an admin must add the connector in the xAI console first. Otherwise check xAI's current connector documentation.
Grok says there is no ServiceTitan tool. Ask: Using DeepLedger, list this company's connections. If ServiceTitan is not listed, check the company's Connections tab, or ask which company is active.
Grok answers from the wrong company. Ask "which company am I in?" and switch. Another AI app may have moved your active company.
The API returns an authentication error. The authorization field must carry a DeepLedger key starting with dl_live_, not your xAI key.
The API job reports "Switch not allowed". The key was created for One company. That is by design; use another key to work in another company.
A ServiceTitan area is missing a scope. Add that read scope to your app in ServiceTitan's developer portal and run the connection check again.
Frequently asked questions
How do I connect ServiceTitan to Grok?
Connect ServiceTitan to the company in DeepLedger first, with your own read-only ServiceTitan app entered on the company's Connections tab. Then open grok.com/connectors, choose New Connector, then Custom, paste https://mcp.deepledger.ai/mcp and sign in with your DeepLedger account. Ask Grok which company you are in and whether ServiceTitan is connected.
How do Grok Business and Enterprise teams add DeepLedger?
A team admin adds it first in the xAI console under Grok Business, Connectors, Add Connector, Other, with the DeepLedger address. Members then connect their own accounts at grok.com/connectors and sign in to DeepLedger as themselves, so each person reaches only the companies they are assigned to.
Can I read ServiceTitan from the xAI API?
Yes. Add a tool of type mcp to a Responses API request with server_url set to https://mcp.deepledger.ai/mcp and authorization set to a DeepLedger API key. The Responses API does not ask for approval before tool calls, so limit allowed_tools to DeepLedger's read tools for a ServiceTitan job.
Can Grok change anything in ServiceTitan?
No. The ServiceTitan connection is read only. DeepLedger sends ServiceTitan only read requests, plus its own sign-in, and refuses anything else before it is sent, so Grok cannot create, edit or delete a job, invoice or payment in ServiceTitan.
Is Grok Bot set up the same way?
No. Grok Bot is xAI's computer-use agent and adds connectors in its own app, not at grok.com/connectors. See Connect ServiceTitan to Grok Bot for those steps.
Related guides
- Connect ServiceTitan to your AI agent
- Connect ServiceTitan to Grok Bot
- Connect Grok to Xero
- Grok and QuickBooks Online setup
- Connect ServiceTitan to Cursor
See every supported app on AI platforms and integrations.