Microsoft Copilot reads Housecall Pro through an agent you build in Copilot Studio: add DeepLedger's MCP server at https://mcp.deepledger.ai/mcp as the agent's tool, and the agent reads the company's Housecall Pro jobs, estimates, invoices and payments next to its QuickBooks or Xero books. You can then publish the agent to Microsoft 365 Copilot and Teams. The Housecall Pro side is read only.
This guide is for firms and finance teams that work in Microsoft 365 and keep the books for home service businesses on Housecall Pro. One agent serves the whole team; each person brings their own DeepLedger access.
DeepLedger is an independent integration. It is not affiliated with or endorsed by Housecall Pro. The general Housecall Pro guide, with every tool and limit, is Connect Housecall Pro to your AI agent.
Which Copilot can read Housecall Pro?
Microsoft uses the Copilot name for several products. Only some of them can add an MCP server.
| Product | Route to Housecall Pro |
|---|---|
| Copilot Studio | Add DeepLedger as a Model Context Protocol tool on an agent |
| Microsoft 365 Copilot | Use the published Copilot Studio agent |
| Microsoft Teams | Use the same agent, added through the Teams channel |
| GitHub Copilot in VS Code | Add DeepLedger as a remote MCP server |
The consumer Copilot app connects only to a short list of services Microsoft names, such as OneDrive and Outlook.com (Microsoft's connectors page), so it has no route to Housecall Pro.
What the agent reads in Housecall Pro
DeepLedger gives the agent four read-only Housecall Pro tools:
- Company and lists: the company's name, time zone and locations; customers, employees, job types, tags, lead sources, price book services and materials.
- Jobs: customer, service city, status, schedule, totals and outstanding balance, plus a job's line items, invoices, materials and appointments.
- Estimates: estimates and their options, with totals and approval status.
- Invoices: amount, amount due, taxes, discounts and payments (method, amount, date), and line items on a single invoice.
Amounts come back in dollars. Customer and employee email addresses and phone numbers, street addresses, notes, attachments and payment notes are left out of every answer. Text your staff typed into job or line item descriptions comes through as written. Each call reads, answers and keeps no Housecall Pro records; DeepLedger keeps only the saved key, encrypted.
Before you start
- Housecall Pro with the API turned on for your plan. Housecall Pro names MAX for API keys and its API page also lists XL (as of November 2026). Only a Housecall Pro admin can generate the key.
- Housecall Pro's permission for this connection. Housecall Pro's API terms set rules for apps built on its API, including how API keys are shared. Check that Housecall Pro allows this connection for your account before you connect.
- A DeepLedger account with the company set up, usually with QuickBooks Online or Xero connected, and an owner or admin to paste the Housecall Pro key.
- A Copilot Studio environment where you can create or edit an agent, on a license that includes generative orchestration. Microsoft says the trial cannot publish an agent, and the Copilot Studio for Teams plan does not include generative orchestration (as of November 2026; see Microsoft's licensing page).
- A personal DeepLedger API key for each person who will use the agent: Settings → API keys → Create key, then All my companies so the agent can switch between clients, and an expiration. The value is shown once.
How do I connect Housecall Pro to Copilot Studio?
- Connect Housecall Pro in DeepLedger. A Housecall Pro admin generates a Read-only API key under API Key Management. A DeepLedger owner or admin opens Companies, chooses the company, then Connections, then Housecall Pro, pastes the key and confirms it was generated as Read-only.
- Add the MCP tool. In Copilot Studio, open the agent, go to Tools, select Add a tool, then New tool, then Model Context Protocol. Fill in Server name and Server description, and enter https://mcp.deepledger.ai/mcp as the Server URL.
- Choose API key authentication. Choose API key, then Header, with the header name Authorization. Select Create, then Create a new connection, and enter Bearer followed by your DeepLedger key.
- Use end user credentials. Select Add to agent, then under Credentials to use choose End user credentials before you share the agent.
- Check the connection. In the test pane, ask: Which company am I in? Read the Housecall Pro company and tell me its name and time zone.
Give the tool a description that says what it is for, for example "Reads Housecall Pro jobs, invoices and payments and the books in QuickBooks or Xero through DeepLedger". Steps 2 and 3 follow Microsoft's guide to adding an existing MCP server, checked in November 2026; step 4 follows its tool authentication guide. Microsoft's MCP overview says the agent needs generative orchestration turned on to use MCP tools.
Microsoft's guide also offers OAuth 2.0 with Dynamic discovery for servers that support dynamic client registration, which DeepLedger does. DeepLedger's own Copilot guides use the API key route above; if you choose OAuth instead, each person signs in to DeepLedger in the browser rather than pasting a key.
If the agent already has DeepLedger as a tool for QuickBooks or Xero, skip steps 2 to 4. The same tool reaches Housecall Pro once the company has it connected in DeepLedger.
Why end user credentials matter
With End user credentials, each person enters their own DeepLedger key once, and every call runs as that person: a staff accountant reaches only the companies they are assigned to. With Maker-provided credentials, everyone uses the maker's key, and with it the maker's companies. A DeepLedger key has no read-only setting of its own, and the same key reaches the ledger tools, which include writes. Choose End user credentials before anyone else opens the agent.
Publish to Teams and Microsoft 365 Copilot
- Publish the agent in Copilot Studio at least once.
- Open Channels and select Microsoft 365 and Microsoft Teams.
- Keep Make agent available in Microsoft Copilot ticked if you want both, then select Add channel.
- Select See agent in Teams, then Add, and repeat the company check from step 5 in Teams.
- Share the agent only with the people who should use it.
These labels follow Microsoft's Teams and Microsoft 365 publishing guide. Tenant policies can block installation, and broader distribution can need an administrator's approval, so test as a colleague who is not the maker before rollout.
Microsoft 365 Copilot's own Agent Builder does not support actions that reach external services, and points you to Copilot Studio instead (Microsoft's Agent Builder page). If colleagues cannot sign in to the tool in Teams, Microsoft's Teams single sign-on guide covers Microsoft Entra ID sign-in for one-to-one chats with the agent.
Agent instructions for field service clients
Copilot Studio agents follow written instructions. A short block keeps the Housecall Pro work consistent:
Before answering, name the active company. For Housecall Pro questions, read Housecall Pro and the books side by side and show both figures. Never change records unless the user asks for a specific change in the books. When figures differ, list the difference and the likely cause for a reviewer.
Instructions shape behaviour; they are not a permission. The Housecall Pro tools are reads because DeepLedger allows nothing else, not because of the instructions.
Prompts for a Teams chat
Switch to Bright Path Plumbing. Do not change anything. List Housecall Pro invoices paid last week with each payment's method, amount and date, totalled by day, and compare each day with the bank deposits in the books.
List Housecall Pro invoices that are open or pending payment with due date and amount due. Show the AR aging in the books as of today, by customer, with the difference.
Which Housecall Pro jobs scheduled in October 2026 are completed but have no invoice? Show job, customer city, date and total.
Read the approved Housecall Pro estimates scheduled in October 2026 and their option totals, and tell me which have no job yet.
Bright Path Plumbing is a fictional business. For the full checks, see How do I check Housecall Pro against QuickBooks or Xero? in the Housecall Pro guide.
Use GitHub Copilot in VS Code instead
GitHub Copilot in Visual Studio Code is a separate MCP client, and it signs in with OAuth, so no API key is needed. In VS Code, run Chat: Open Customizations, open MCP Servers, select Add Server, choose Global, then Copilot Global, and enter the address. The entry in your user MCP configuration, ~/.copilot/mcp-config.json, looks like this:
{
"mcpServers": {
"deepledger": {
"type": "http",
"url": "https://mcp.deepledger.ai/mcp",
"tools": ["*"]
}
}
}
Then choose the server's Authenticate action and sign in to DeepLedger in the browser. VS Code's MCP configuration reference says the Local harness is deprecated and will be removed in February 2027, and that new Copilot setups should use the native files above rather than .vscode/mcp.json, which uses that harness's servers format. On Copilot Business and Enterprise, an admin must first turn on the MCP servers in Copilot policy, which is off by default (GitHub's MCP guide).
Troubleshooting
401 or unauthorized. The connection value must be Bearer plus the full DeepLedger key, with the header name Authorization.
The agent says it has no Housecall Pro tool. DeepLedger offers the Housecall Pro tools when you ask for Housecall Pro data. Ask: Using DeepLedger, list this company's connections, then read Housecall Pro jobs. If Housecall Pro is not listed, check the company's Connections tab.
Housecall Pro needs reconnecting. The Housecall Pro key was deleted or no longer works. Generate a new Read-only key and paste it on the company's Connections tab.
New tools take a while to appear. Microsoft's MCP troubleshooting page says tools added, removed or renamed on a server can take 12 to 24 hours to show in Copilot Studio, with no manual refresh. Ask for Housecall Pro data through DeepLedger's connections list in the meantime.
Colleagues are asked to create a connection. That is expected with End user credentials. Each person enters Bearer and their own DeepLedger key once.
"Switch not allowed." The DeepLedger key was created for One company. Create one for All my companies.
A location's jobs are missing. A Housecall Pro key reaches its own location and the locations beneath it. Ask the agent to list the company's locations and read the missing one by name.
Is it safe?
- Each person uses their own access. With End user credentials, the agent reaches only the companies the person using it is assigned to.
- Read only in DeepLedger. DeepLedger sends Housecall Pro only read requests, whatever the key allows; the Read-only key is a second fence.
- Revoking access. Disconnect Housecall Pro on the company's Connections tab, or delete the key in Housecall Pro's API Key Management. Revoke a person's DeepLedger API key under Settings → API keys to stop the agent for them.
Frequently asked questions
Can Microsoft Copilot read Housecall Pro?
Yes, through an agent you build in Copilot Studio. Add DeepLedger's MCP server at https://mcp.deepledger.ai/mcp as the agent's tool, and the agent reads Housecall Pro jobs, estimates, invoices and payments for any company where Housecall Pro is connected in DeepLedger.
Can the Copilot agent change anything in Housecall Pro?
No. The agent's DeepLedger tool only reads Housecall Pro. DeepLedger refuses any request to Housecall Pro other than a read before it is sent, so whoever chats with the agent in Teams or Microsoft 365 Copilot cannot create, edit or delete a customer, job, estimate or invoice in Housecall Pro.
Does every person need their own DeepLedger key?
Yes, when the tool uses End user credentials, which is the setting to choose before you share the agent. Each person creates a DeepLedger API key and enters it once, so the agent reaches only the companies that person is assigned to.
Which Copilot Studio license do I need?
A Copilot Studio subscription that includes generative orchestration, which MCP tools need. Microsoft says the trial lets you build and test an agent but not publish it, and the Copilot Studio for Teams plan does not include generative orchestration (as of November 2026).
Can I use GitHub Copilot instead?
Yes. GitHub Copilot in Visual Studio Code is a separate MCP client. Add https://mcp.deepledger.ai/mcp as an HTTP server and sign in to DeepLedger in the browser. On Copilot Business and Enterprise, an admin must turn on the MCP servers in Copilot policy first.
Related guides
- Connect Housecall Pro to your AI agent
- Connect Microsoft Copilot to QuickBooks Online
- Connect Microsoft Copilot to Xero
- Connect Housecall Pro to ChatGPT
See every supported app on AI platforms and integrations.