DeepLedger
Menu

Bookkeeping

Connect ServiceTitan to Grok With QuickBooks or Xero

Read ServiceTitan jobs, invoices and payments from Grok next to QuickBooks or Xero with one DeepLedger connector, or from the xAI API. Setup and prompts.

Published by DeepLedger8 min read

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

RouteWho it is forHow it signs in to DeepLedger
Grok custom connectorAnyone using Grok chat on the web or in the appYour DeepLedger sign-in
Grok Business or EnterpriseTeams, after an admin adds the connectorEach member's own sign-in
xAI Responses APIScripts and agents your developers runA 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:

  1. A ServiceTitan admin creates an app in ServiceTitan's developer portal with read scopes only; CRM: Customers is required to connect.
  2. The admin connects the app to your tenant under Settings → Integrations → API Application Access and generates the client id and client secret.
  3. 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.

  1. Open connectors. Open grok.com/connectors while signed in to Grok.
  2. Add a custom connector. Choose New Connector, then Custom, and paste https://mcp.deepledger.ai/mcp.
  3. Sign in to DeepLedger. Sign in with your DeepLedger account when Grok sends you to the sign-in page, never your ServiceTitan login.
  4. 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_approval in the Responses API, so nothing asks before a tool runs. Limiting allowed_tools to reads keeps the job to reads.
  • callReadTool runs reads only, in ServiceTitan and in the books, and refuses any call that would change data. connections and describeTool are read only too.
  • companies is 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.

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