DeepLedger
Menu

Bookkeeping

Connect ServiceTitan to Microsoft Copilot Studio and Teams

Build a Copilot Studio agent that reads ServiceTitan next to QuickBooks or Xero through DeepLedger, then use it in Microsoft 365 Copilot and Teams.

Published by DeepLedger11 min read

You connect ServiceTitan to Microsoft Copilot by building an agent in Copilot Studio and adding DeepLedger's MCP server, https://mcp.deepledger.ai/mcp, as one of its tools. Once ServiceTitan is connected to the company in DeepLedger with your own read-only ServiceTitan app, the agent reads jobs, invoices, payments, purchase orders and vendors next to the company's QuickBooks Online or Xero books. Publish it, and your team uses it in Microsoft 365 Copilot and Teams.

This guide is for accounting firms and finance teams that work in Microsoft 365 and look after field service businesses on ServiceTitan. It covers which Copilot to use, the agent setup, the instructions that keep answers grounded, and publishing to Teams.

DeepLedger is an independent integration. It is not affiliated with or endorsed by ServiceTitan or Microsoft.

Which Copilot does what?

Microsoft uses the Copilot name for several products. Only some of them can add an MCP server.

ProductRoute to ServiceTitan in this guide
Copilot StudioBuild the agent and add DeepLedger as a Model Context Protocol tool
Microsoft 365 CopilotUse the published agent
Microsoft TeamsUse the same agent in a one-to-one chat
GitHub Copilot in VS CodeAdd DeepLedger as a remote MCP server (end of this guide)

This guide does not cover the consumer Copilot app.

Why an agent, and whose access it uses

A Copilot Studio agent is shared by many people, and they do not all look after the same clients. DeepLedger lets the agent be built once while the access comes from the person using it:

  • End user credentials. Each person supplies their own DeepLedger API key. Every call runs as that person, so each one reaches only the companies they are assigned to in DeepLedger.
  • A key per purpose. A key created for All my companies follows the person's active company and can switch. A key created for One company stays in that company and cannot switch, which suits an agent for one client.
  • Read only toward ServiceTitan, whoever asks. No key and no agent instruction can make DeepLedger write to ServiceTitan.

A DeepLedger key acts as the person who created it and has no read-only setting of its own. The same agent can reach the ledger tools that draft or post, if that person may use them. For an agent that should only read, give it to people who are read-only members in DeepLedger.

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. Full steps: Connect ServiceTitan to your AI agent.
  • A Copilot Studio environment where you can create or edit an agent. Power Platform data policies that govern connectors also govern MCP servers in Copilot Studio, so check with your admin if tools are blocked.
  • Generative orchestration turned on for the agent. Microsoft's MCP overview says: "You must turn on generative orchestration to use MCP." New agents use it by default. Check the agent's Settings, Generative AI, Orchestration, where Use generative AI orchestration for your agent's responses? should be Yes. If an admin has turned generative orchestration off for the environment, agents there can only use classic orchestration.
  • A DeepLedger API key for each person who will use the agent. Any team member can create one.

How do I connect ServiceTitan to a Copilot Studio agent?

These steps follow Microsoft's guide to connecting an existing MCP server, which uses its MCP onboarding wizard.

  1. Create a DeepLedger API key. In DeepLedger, open Settings, then API keys, then Create key, and choose All my companies or One company and an expiration.
  2. Add a Model Context Protocol tool. In Copilot Studio, open the agent's Tools page, select Add a tool, then New tool, then Model Context Protocol.
  3. Describe the server. Enter a server name, a description that names ServiceTitan, QuickBooks and Xero, and the server URL https://mcp.deepledger.ai/mcp.
  4. Set the API key header. Choose API key, then Header, with the header name Authorization, and select Create.
  5. Create the connection. Create a new connection, enter Bearer followed by your DeepLedger key, and select Add to agent.
  6. Use end user credentials. In the tool's settings, under Credentials to use, choose End user credentials before you share the agent.

The key value is shown once in DeepLedger. Keep it out of the agent's instructions, topics and files.

Why the description matters. Microsoft says the agent's orchestrator uses the server description to decide whether to call the server at runtime. A description such as "Reads ServiceTitan jobs, invoices, payments and purchase orders and the QuickBooks Online or Xero books for our client companies through DeepLedger" helps the agent pick DeepLedger for ServiceTitan questions.

Test it in Copilot Studio's test pane:

Which company am I in? Check the ServiceTitan connection and list which areas it can read.

Agent instructions for ServiceTitan work

Instructions guide the model; DeepLedger's results are the evidence. A short block like this keeps answers checkable:

Use DeepLedger for every question about ServiceTitan, QuickBooks or Xero.
Start each answer with the active company's name.
Treat ServiceTitan as read only: never offer to change a job, invoice or payment there.
When ServiceTitan and the books disagree, list both sides with amounts and dates,
and offer to create a DeepLedger task for a reviewer.
If a ServiceTitan area is reported as missing a read scope, say so instead of
answering from the other side alone.

ServiceTitan's tools may not appear by name in the agent's tool list. The agent reaches them through DeepLedger's connections, describeTool and callReadTool, which are read only.

Prompts for a team in Teams

Before a client call

In Bayview Mechanical, summarize October 2026 in ServiceTitan: invoices dated in October, payments received, jobs completed with no invoice, and open purchase orders. Then show October revenue in the books next to the invoice total.

Payments against deposits

List ServiceTitan payments with a paid date in October 2026, totalled by day, and compare each day with the deposits in the books. List the days that differ.

A customer question from the field team

Has Pinecrest Property Group paid its October 2026 invoices? Show the customer's ServiceTitan invoices dated October, the ServiceTitan payments received from that customer since, and the same invoices in the books.

Purchasing check

List ServiceTitan purchase orders for October 2026 jobs that are not closed. For each, tell me whether a vendor bill is in the books.

Hand it to a reviewer

Put every difference you found in one table and create a DeepLedger task for each one a person needs to decide.

The tasks appear in DeepLedger for a reviewer to work through. Corrections are made by a person in ServiceTitan or the ledger, never through the agent.

Publish to Microsoft 365 Copilot and Teams

  1. Publish the agent in Copilot Studio.
  2. Under Channels, select the Microsoft 365 and Microsoft Teams tile, keep Make agent available in Microsoft Copilot selected, and select Add channel.
  3. Install it for yourself and repeat the ServiceTitan check in Teams.
  4. Share it only with the people who should use it.

Two sign-ins are involved. Signing in to the agent in Teams is Microsoft's side: Microsoft's Teams SSO guide says SSO works in one-to-one chats with the agent, not in group chats or channels. The DeepLedger connection is separate: with end user credentials, each person is asked once for their own DeepLedger key. Test as a user who did not build the agent before rollout.

Use GitHub Copilot in VS Code instead

GitHub Copilot in Visual Studio Code is a separate MCP client that signs in with OAuth, so no API key is needed. In a chat session on the Copilot harness, run Chat: Open Customizations, select MCP Servers, then Add Server, enter the address, and for a personal setup choose Global, then Copilot Global. That writes the server to ~/.copilot/mcp-config.json; a team can share the same entry in .mcp.json at the workspace root. Both files use a top-level mcpServers object:

{
  "mcpServers": {
    "deepledger": {
      "type": "http",
      "url": "https://mcp.deepledger.ai/mcp",
      "tools": ["*"]
    }
  }
}

Select Authenticate in the server's actions when VS Code offers it, sign in to DeepLedger in the browser, then ask a question that makes a tool call: VS Code says adding a configuration alone does not confirm the session can use the server. These steps follow VS Code's MCP configuration reference, which says the older .vscode/mcp.json file with a servers key belongs to the Local harness, which is deprecated and will be removed in February 2027, so new setups should not use it.

Is it safe to connect ServiceTitan to Copilot?

  • Read only, in code. 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.
  • End user credentials, not the maker's. Maker-provided credentials would let every user act with the maker's DeepLedger access. Use them only for a private test.
  • Revoking access. Remove the tool from the agent, revoke the key under Settings → API keys in DeepLedger, or disconnect ServiceTitan on the company's Connections tab. Disconnecting ServiceTitan stops its tools at once.

Troubleshooting

What you seeWhat to do
The agent never calls DeepLedgerRewrite the server description so it names ServiceTitan and the ledger, and say in the instructions to use DeepLedger.
Authentication failsThe connection value must be Bearer followed by a DeepLedger key starting with dl_live_, and the key must not be revoked or expired.
Every user sees the maker's companiesCredentials to use is still set to the maker. Switch it to End user credentials and republish.
"Switch not allowed"The key was created for One company. That is by design; use an All my companies key to move between clients.
A ServiceTitan area is missing a scopeAdd that read scope to the app in ServiceTitan's developer portal, then run the connection check again.
The tool is blocked in the environmentA Power Platform data policy covers it. Ask your Power Platform admin.
The agent cannot use the MCP tool at allGenerative orchestration is off. In the agent's Settings, under Generative AI, Orchestration, set Use generative AI orchestration for your agent's responses? to Yes. If the environment allows only classic orchestration, ask your admin.
Users cannot sign in in a Teams group chatMicrosoft's SSO path works in one-to-one chats with the agent. Use a one-to-one chat.

Frequently asked questions

Can Microsoft Copilot read ServiceTitan?

Yes, through an agent you build in Microsoft Copilot Studio. Add DeepLedger's MCP server at https://mcp.deepledger.ai/mcp as a tool on the agent, and the agent reads ServiceTitan jobs, invoices, payments and purchase orders next to the company's QuickBooks Online or Xero books. You can then publish the agent to Microsoft 365 Copilot and Teams.

Which authentication do I choose in Copilot Studio?

API key, sent as a header named Authorization, with the value Bearer followed by a DeepLedger API key. Set the tool to End user credentials before you share the agent, so each person uses their own key and reaches only their own companies. Microsoft also offers OAuth 2.0 in the same wizard; DeepLedger's Copilot guides use the API key route.

Can a Copilot Studio agent 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 the agent cannot create, edit or delete a job, invoice or payment in ServiceTitan, whatever its instructions say.

Can I build a Copilot agent for one field service client only?

Yes. With End user credentials, each person can enter a DeepLedger API key created for One company, so the agent stays in that client's books and ServiceTitan tenant and cannot switch. A key created for All my companies follows the person's active company instead.

Does this work in the consumer Copilot app?

No. This guide uses an agent built in Copilot Studio and published to Microsoft 365 Copilot and Teams. It does not cover the consumer Copilot 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