DeepLedger
Menu

Bookkeeping

Connect Housecall Pro to Your AI Agent With QuickBooks or Xero

An AI agent can read your Housecall Pro jobs, estimates, invoices and payments next to the books in QuickBooks or Xero. The read-only API key setup, what it reads, and prompts that tie field work to the ledger.

Published by DeepLedger11 min read

You connect Housecall Pro to an AI agent through DeepLedger: a Housecall Pro admin generates a read-only API key, a DeepLedger owner or admin pastes it on the company's Connections tab, and your AI app reaches it at https://mcp.deepledger.ai/mcp. The AI agent can then read jobs, estimates, invoices and payments in Housecall Pro next to the company's books in QuickBooks or Xero. It cannot change anything in Housecall Pro.

This guide is for accounting firms, bookkeepers and owners who keep the books for home service businesses that run on Housecall Pro. It covers what the AI agent reads, the setup, prompts that check revenue, receivables and deposits against the ledger, and the limits to know before you start.

DeepLedger is an independent integration. It is not affiliated with or endorsed by Housecall Pro.

What the AI agent can read in Housecall Pro

DeepLedger gives the AI agent four read-only Housecall Pro tools. Amounts come back in dollars.

AreaRecordsUseful filters
Company and listsThe company (name, time zone, locations), customers, employees, job types, tags, lead sources, price book services, materialsEntity type; one customer by id
JobsJobs with customer, service city, status, schedule, totals and outstanding balance; a job's line items, invoices, materials and appointmentsCustomer, scheduled dates
EstimatesEstimates and their options, with totals and approval status; an option's line itemsCustomer, scheduled dates
InvoicesInvoices with amount, amount due, taxes, discounts and payments (method, amount, date); line items on a single invoiceStatus, customer, created, due and paid dates, payment method

A filter that does not apply to a record type is refused before anything is sent, never dropped, so an answer that says it is filtered really is. Deleted jobs are left out of a job list unless you ask for them. For a business with several locations, the AI agent can read one location at a time.

What it cannot do

  • Change Housecall Pro. Every Housecall Pro tool is a read. DeepLedger sends Housecall Pro only read requests, to a fixed list of routes, and refuses any other request before it is sent. That rule is DeepLedger's own, so it holds whatever the key allows.
  • See contact details. 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.
  • Keep your data. Each call reads, answers and keeps no Housecall Pro records. DeepLedger keeps the saved key, encrypted.

Before you start

  • A Housecall Pro plan with API access. Housecall Pro names the MAX plan for API keys, and its API page also lists XL (as of November 2026).
  • 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 Housecall Pro admin. Only an admin can generate or delete API keys.
  • A DeepLedger account with the company set up, usually with QuickBooks Online or Xero already connected. The trial needs no card.
  • An owner or admin in DeepLedger, to paste the key.
  • An AI app that supports custom MCP connectors: Claude, ChatGPT, Gemini, Grok, Grok Bot, Microsoft Copilot Studio, Cursor, or your own agent.

How do I connect Housecall Pro to an AI agent?

  1. Generate a read-only API key. A Housecall Pro admin opens My Apps, then the App Store, searches for API, opens API Key Management and selects Generate API Key. Name the key DeepLedger and choose Read-only permissions.
  2. Enter the key in DeepLedger. 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.
  3. Add the connector once. In your AI app, add https://mcp.deepledger.ai/mcp as a custom connector and sign in with your DeepLedger account. If you already use DeepLedger for QuickBooks or Xero, skip this step.
  4. Check the connection. Ask: Using DeepLedger, which company am I in? Read the Housecall Pro company and tell me its name and time zone.

DeepLedger saves only a key you confirm was generated as Read-only, encrypts it and ties it to that one company. The key is never shown again, never logged and never sent to the AI agent. Choose Read-only even so: it is a second fence behind DeepLedger's own read-only rule.

If the company name in the answer is not the business you expected, the key belongs to another Housecall Pro account. Disconnect it and paste the right one.

Add DeepLedger to your AI app

The address is the same in every app: https://mcp.deepledger.ai/mcp. Sign in with your DeepLedger account when asked, never your Housecall Pro login.

  • Claude: open Customize, then Connectors, select + Add, then Add custom connector, and paste the address. On Team and Enterprise, an owner adds DeepLedger first. Full steps: connect Housecall Pro to Claude.
  • ChatGPT: go to chatgpt.com/plugins, select +, then Add custom MCP server, enter the address and choose OAuth. Switching between companies needs a ChatGPT Business, Enterprise or Edu workspace (as of November 2026). Full steps: connect ChatGPT to Xero.
  • Gemini: on the web, open Settings, then Connected Apps, and add a custom app with the address. The steps match the Gemini guide for Xero.
  • Grok: open grok.com/connectors, choose New Connector, then Custom, and paste the address. The steps match the Grok guide for Xero.
  • Grok Bot: in the Grok Bot desktop app, open Connect apps, choose Add a custom connector, pick Remote HTTPS and enter the address. Grok Bot keeps its own list, separate from Grok chat. Full steps: connect Housecall Pro to Grok Bot.
  • Microsoft Copilot Studio: add a Model Context Protocol tool with the address and a personal DeepLedger API key. Create the key for All my companies so the agent can switch. The steps match the Copilot guide for Xero.
  • Cursor and your own agents: any client that supports remote MCP servers with OAuth can use the same address.

Connect from your AI app. Step-by-step Housecall Pro guides for each app:

How do I check Housecall Pro against QuickBooks or Xero?

Many Housecall Pro businesses send invoices and payments to the books with Housecall Pro's own QuickBooks sync or a similar tool. The two still drift: an invoice edited after it synced, a payment recorded twice, a job finished but never invoiced, a deleted job still counted somewhere. The AI agent reads both sides and lists the differences. Start each prompt with "do not change anything" and name the company.

1. Paid invoices against deposits

In Bright Path Plumbing, do not change anything. List Housecall Pro invoices paid in October 2026 with each payment's method, amount and date, totalled by day. Compare each day's total with the deposits in the books for the same days, and list any day that does not match.

Card payments often reach the bank as one deposit for several invoices, less fees. If the books hold payments in Undeposited Funds first, ask the AI agent to compare against that account too.

2. Open invoices against receivables

List Housecall Pro invoices with status open or pending payment, with job, due date and amount due, and read each job's customer. Then show the AR aging in the books as of today. Make one table by customer with both totals and the difference.

3. Finished jobs with no invoice

List Housecall Pro jobs scheduled in October 2026 with status and outstanding balance. For each completed job, list its invoices, and show completed jobs with no invoice.

4. Revenue against the books

List Housecall Pro invoices created from September 15 to November 15, 2026, and keep those whose invoice date is in October 2026, with subtotal, taxes, discounts and total. Compare the totals with revenue and sales tax in the books for October 2026, and list invoices that are in Housecall Pro but not in the books.

5. Job materials against costs

List Housecall Pro jobs scheduled in October 2026 and keep the completed ones. For the ten largest, list the materials on each job. Compare them with the bills and expenses coded to those jobs or customers in the books.

6. Turn the differences into tasks

Summarize every difference you found in one table: customer, side, document, amount and the likely cause. Create a task for each one that needs a person to decide.

The tasks appear in DeepLedger for a reviewer to work through. Fix each difference where it belongs: in Housecall Pro, in the ledger, or in the sync. For the full close, see the QuickBooks month-end close checklist or the Xero month-end close checklist.

Limits worth knowing

  • Read only. Changes are made in Housecall Pro or the ledger by a person, never by the AI agent through Housecall Pro.
  • One key per company. Each DeepLedger company connects to its own Housecall Pro account with its own key.
  • Use the tax amount. A tax rate comes through exactly as Housecall Pro sends it; use each tax's amount for any total.
  • Large lists come in pages. Ask for a narrower date range or one customer when a list is long.
  • Rate limits. If Housecall Pro asks DeepLedger to slow down for longer than a short wait, the AI agent says so and when to try again.

Is it safe?

  • Each person signs in as themselves. Members reach only the companies they are assigned to; owners and admins see every company.
  • Read only in DeepLedger. DeepLedger sends only read requests, whatever the key allows; a 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, and the AI agent can no longer read the account. Remove the connector in your AI app to stop DeepLedger everywhere.

Troubleshooting

What you seeWhat to do
Housecall Pro needs reconnectingThe key was deleted or no longer works. Generate a new Read-only key and paste it on the company's Connections tab.
Housecall Pro says the saved key was not marked Read-onlyGenerate a Read-only key and connect again on the company's Connections tab.
The wrong business answersThe key belongs to another Housecall Pro account. Disconnect it and paste the right key.
A location's jobs are missingA Housecall Pro key reaches its own location and the locations beneath it. Ask the AI agent to list the company's locations and read the missing one by name; a location that is not listed is outside the key's reach.
The AI agent says it has no Housecall Pro toolDeepLedger 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 connected, check the company's Connections tab.
The answer shows the wrong clientAsk which company is active and switch. See one sign-in, every company.

Frequently asked questions

Can an AI agent read Housecall Pro?

Yes. Through DeepLedger, an AI agent reads a company's Housecall Pro jobs with their line items, materials and appointments, estimates and their options, invoices with taxes, discounts and payments, and lists such as customers, employees, job types and the price book. It reads them in the same conversation as the company's QuickBooks or Xero books.

Can the AI agent change anything in Housecall Pro?

No. The Housecall Pro connection is read only. DeepLedger sends Housecall Pro only read requests, and refuses any other request before it is sent, so the AI agent cannot create, edit or delete a customer, job, estimate or invoice.

Which Housecall Pro plan do I need?

A plan that includes Housecall Pro's API. Housecall Pro names the MAX plan for API keys, and its API page also lists XL (as of November 2026), and only a Housecall Pro admin can generate a key.

Does the AI agent see my customers' phone numbers and addresses?

Not from Housecall Pro's contact fields. DeepLedger leaves out customer and employee email addresses and phone numbers, street addresses, notes and attachments. A customer's place comes through as city, state, zip and country. Text your staff typed into job or line item descriptions comes through as written.

Does this replace Housecall Pro's QuickBooks integration?

No. DeepLedger does not sync anything into the books. Keep the sync you use today; the AI agent reads Housecall Pro and the ledger side by side and lists where they disagree, for a person to review.

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