You connect ServiceTitan to Cursor through DeepLedger: connect ServiceTitan once to the company in DeepLedger with your own read-only ServiceTitan app, then add one mcp.json entry for https://mcp.deepledger.ai/mcp. Cursor's agent can then read ServiceTitan jobs, invoices, payments, purchase orders and the accounting export feeds next to the company's QuickBooks Online or Xero books, and write the comparison to files in your project. Nothing in ServiceTitan can be changed from Cursor.
This guide is for the finance people who already work in Cursor, and for developers who build reporting and close tooling for field service clients. It covers the configuration, how Cursor's approvals treat the ServiceTitan reads, prompts that produce files, and where to look when a call fails.
DeepLedger is an independent integration. It is not affiliated with or endorsed by ServiceTitan or Cursor.
What you are connecting
| OAuth sign-in | DeepLedger API key | |
|---|---|---|
| Best for | Cursor on your own computer | A setup where a browser sign-in is not possible |
What goes in mcp.json | The url only | The url and an Authorization header |
| Acts as | You | The person who created the key |
| Reaches | Every company you can access | All your companies, or one company |
| Revoke in DeepLedger | Settings → Connected apps | Settings → API keys |
Either way, Cursor never sees the ServiceTitan credentials. DeepLedger holds them per company and reads ServiceTitan with your company's own app.
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.
- ServiceTitan connected to the company in DeepLedger. A ServiceTitan admin creates a read-only app in ServiceTitan's developer portal (CRM: Customers is required) and connects it to your tenant under Settings → Integrations → API Application Access; a DeepLedger owner or admin enters the client id, client secret, app key and tenant id under Companies, the company, Connections, ServiceTitan. The full walkthrough is Connect ServiceTitan to your AI agent.
- A DeepLedger account with the company's books connected. The trial needs no card.
- Cursor desktop. On Enterprise, admins can restrict which MCP servers and tools are allowed.
How do I connect ServiceTitan to Cursor?
These steps follow Cursor's MCP documentation. If DeepLedger is already in your mcp.json for QuickBooks or Xero, skip to step 3.
- Add DeepLedger to mcp.json. Add a deepledger entry with the url
https://mcp.deepledger.ai/mcpto~/.cursor/mcp.jsonfor every project, or.cursor/mcp.jsonfor one project, keeping any servers already there.
{
"mcpServers": {
"deepledger": {
"url": "https://mcp.deepledger.ai/mcp"
}
}
}
- Turn it on and sign in. Open the Customize page in Cursor's sidebar, turn DeepLedger on and sign in with your DeepLedger account.
- Check the tools. Check that
companies,connections,describeToolandcallReadToolappear under Available Tools. - Ask in Agent chat. In Agent chat, ask which company you are in and whether ServiceTitan is connected.
Using DeepLedger, which company am I in? Check the ServiceTitan connection and list which areas it can read.
DeepLedger supports OAuth discovery and dynamic client registration, so the auth object Cursor offers for fixed client credentials is not needed.
You may not see tools named after ServiceTitan. DeepLedger can reach ServiceTitan through callReadTool, with describeTool for each tool's fields, rather than listing every ServiceTitan tool. That is why step 3 checks those names.
Using an API key instead
Create a key under Settings → API keys → Create key in DeepLedger. For a project that belongs to one client, choose One company, so the key cannot switch to another company. Keep the key in an environment variable, never in the file:
{
"mcpServers": {
"deepledger": {
"url": "https://mcp.deepledger.ai/mcp",
"headers": {
"Authorization": "Bearer ${env:DEEPLEDGER_API_KEY}"
}
}
}
}
A project's .cursor/mcp.json is often committed with the code. The variable reference is safe to commit; the key is not.
How Cursor's approvals treat ServiceTitan reads
Cursor asks for approval before it uses an MCP tool, by default. In auto-review mode, tools on your allowlist run at once and the rest go through Cursor's classifier.
callReadToolcan go on the allowlist for ServiceTitan work. It runs reads only, in ServiceTitan and in the books, and refuses any call that would change data.connectionsanddescribeToolare read only as well.- Keep the ledger write tools off the allowlist. The same server has QuickBooks and Xero tools that draft or post; let Cursor ask for those.
companiescan switch your active company. Read the company in the tool arguments before you approve a switch.
Prompts that write files
Cursor's agent can turn a comparison into files in your project. Name the company and the period, and say where the output goes.
Invoice tie-out to CSV
Using DeepLedger, in Lakeshore Mechanical, do not change anything. List ServiceTitan invoices dated October 2026 and sales invoices in the books for the same month. Match them by invoice number, or customer and amount, and write
out/2026-10-invoice-tieout.csvwith columns side, number, customer, date, ServiceTitan total, books total and difference.
Unbilled jobs
List ServiceTitan jobs completed in October 2026 with no invoice and write them to
out/2026-10-unbilled-jobs.csvwith customer, location and completion date.
Export feed since the close
Read the ServiceTitan invoices export feed for changes since November 1, 2026, page by page until there are no more. Write every invoice dated October 2026 that appears in it to
out/after-close-changes.csv, with its current total and the total in the books.
Payments by day
Total ServiceTitan payments by paid date for October 2026 and compare each day with the deposits in the books. Write a short Markdown summary to
out/2026-10-deposits.mdthat lists the days that differ.
Tasks for a reviewer
For each row in
out/2026-10-invoice-tieout.csvwith a difference, create a DeepLedger task with the customer, the amount and the likely cause.
Add out/ to .gitignore before you start: these files hold client data.
Is it safe to connect ServiceTitan to Cursor?
- Read only toward ServiceTitan. 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.
- 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. Files the agent writes are yours to look after.
- Per-person access. You sign in as yourself and reach only the companies you can access; a One company key reaches one.
- Revoking access. Remove the entry from
mcp.json, 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
The server shows but has no tools. Check the url ends in /mcp, turn the server off and on in Customize, and sign in again.
A call failed and the chat does not say why. Open the Output panel (Cmd+Shift+U on macOS) and choose MCP Logs. Cursor marks failed tool calls in the chat; the log shows the server's answer.
Cursor says there is no ServiceTitan tool. Ask: Using DeepLedger, list this company's connections. If ServiceTitan is missing, it is not connected to the active company; check the Connections tab or switch company.
Authentication error with an API key. Check that DEEPLEDGER_API_KEY is set in the environment Cursor was started from, starts with dl_live_, and has not been revoked.
"Switch not allowed." The key was created for One company. Use an All my companies key or sign in with OAuth 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.
ServiceTitan asked to slow down. If ServiceTitan's rate limit asks for a longer wait, the answer says so and when to try again. Read export feeds page by page rather than asking for everything at once.
Frequently asked questions
How do I connect ServiceTitan to Cursor?
Connect ServiceTitan to the company in DeepLedger first, with your own read-only ServiceTitan app. Then add a deepledger entry with the url https://mcp.deepledger.ai/mcp to ~/.cursor/mcp.json or a project's .cursor/mcp.json, turn it on from the Customize page in Cursor's sidebar, and sign in with your DeepLedger account.
Why don't I see ServiceTitan tools in Cursor's tool list?
DeepLedger may reach ServiceTitan through its general tools rather than listing each ServiceTitan tool. Look for connections, describeTool and callReadTool under Available Tools; Cursor's agent uses them when you ask for ServiceTitan data. All three are read only.
Do I need an API key to use ServiceTitan in Cursor?
No. Cursor supports OAuth for MCP servers, so the url alone is enough and you sign in to DeepLedger in the browser. Use a DeepLedger API key in a headers entry only where a browser sign-in is not possible, and keep the key in an environment variable.
Can Cursor 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 Cursor's agent cannot create, edit or delete a job, invoice or payment in ServiceTitan.
Is it safe to save ServiceTitan data in a Cursor project?
Treat it as client data. DeepLedger keeps no ServiceTitan records, but a CSV or report the agent writes to your project stays on your computer and in any repository you commit it to. Keep such files out of version control and delete them when the work is done.
Related guides
- Connect ServiceTitan to your AI agent
- Connect Cursor to QuickBooks Online
- Connect Cursor to Xero
- Connect ServiceTitan to Claude
- Connect ServiceTitan to Grok
See every supported app on AI platforms and integrations.