Claude reads Housecall Pro through DeepLedger: connect Housecall Pro to the company in DeepLedger with a Read-only API key, add https://mcp.deepledger.ai/mcp to Claude as a custom connector, and Claude can read jobs, estimates, invoices and payments next to the company's QuickBooks or Xero books. Claude cannot change anything in Housecall Pro.
This guide is for bookkeepers and accounting firms who use Claude and keep the books for home service businesses on Housecall Pro. It covers Claude's plan rules, the connector setup for one person and for a Team or Enterprise organization, the permission settings for read-only tools, and prompts that turn field data into month-end answers.
DeepLedger is an independent integration. It is not affiliated with or endorsed by Housecall Pro. Every Housecall Pro tool and limit is in the Housecall Pro AI agent guide.
What you are connecting
Three accounts meet in one conversation:
| Account | Who signs in | What it gives |
|---|---|---|
| Housecall Pro | A Housecall Pro admin creates a Read-only API key | DeepLedger's read access to that one business |
| DeepLedger | An owner or admin pastes the key; you sign in from Claude | Your companies, their books and their Housecall Pro data |
| Claude | You | The conversation |
Claude never sees the Housecall Pro key. DeepLedger saves it encrypted, ties it to one company, and never shows it again, logs it or sends it to the AI agent. Each call reads, answers and keeps no Housecall Pro records.
Through DeepLedger, Claude reads the Housecall Pro company and its lists (customers, employees, job types, tags, lead sources, price book services, materials), jobs with their line items, invoices, materials and appointments, estimates and their options, and invoices with taxes, discounts and payments. Amounts come back in dollars. Customer and employee email addresses and phone numbers, street addresses, notes, attachments and payment notes are left out.
Before you start
- API access in Housecall Pro. The MAX plan is the one Housecall Pro names for API keys; its API page lists XL too (as of November 2026). Keys are generated by a Housecall Pro admin.
- 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 where the company is set up, often with QuickBooks Online or Xero already connected, plus a DeepLedger owner or admin for the key. The trial needs no card.
- A Claude plan with custom connectors. Anthropic's custom connector guide lists Free, Pro, Max, Ultra, Team and Enterprise, with one custom connector on Free (as of November 2026). If your one Free connector is already used, remove it or upgrade first.
How do I connect Housecall Pro to Claude?
- 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 a custom connector. In Claude, open Customize, then Connectors, select + Add, then Add custom connector. Name it DeepLedger, paste https://mcp.deepledger.ai/mcp, select Continue, review the detected settings and select Continue again.
- Sign in to DeepLedger. Keep Sign in now, choose Register automatically for the OAuth client, select Add, then sign in with your DeepLedger account, not your Housecall Pro login, and allow access.
- Turn it on in a chat. In a new chat, open the + menu, then Connectors, and turn DeepLedger on.
- Check the connection. Ask: Using DeepLedger, which company am I in? Read the Housecall Pro company and tell me its name and time zone.
In step 3, Anthropic's guide offers three OAuth client choices and marks Use Claude's published identity as recommended. Choose Register automatically, as DeepLedger's other Claude guides do: DeepLedger supports dynamic client registration, so there is nothing to paste. If DeepLedger is already a connector for QuickBooks or Xero, skip steps 2 and 3.
If the business in the answer is not the one you expected, the Housecall Pro key belongs to another account. An owner or admin disconnects it on the company's Connections tab and pastes the right one.
Team and Enterprise organizations
On Team, only Owners and Primary Owners can add a custom connector; on Enterprise, so can people with a custom role that includes managing access to libraries. The owner opens Organization settings → Connectors, selects Add, then Custom, then Web, and enters the same address. Each member then finds DeepLedger under Customize → Connectors, selects Connect and signs in to DeepLedger as themselves, so each person reaches only the companies they are assigned to.
Set permissions for read-only tools
DeepLedger marks every Housecall Pro tool as read-only. That lets you treat them differently from the ledger tools, which include writes. Depending on how DeepLedger lists its tools to your AI app, Housecall Pro reads may run through DeepLedger's own read tool, titled DeepLedger: Run a Read Tool, instead of tools named for Housecall Pro. That tool only reads, but it covers every app DeepLedger reads that way, not Housecall Pro alone.
- On your own plan, open Customize → Connectors, select DeepLedger and review its tool permissions. When Claude asks to use a Housecall Pro read, Allow always stops the question for that read tool. Keep the ledger's write tools on asking.
- On Team and Enterprise, owners can set each tool to Always allow, Needs approval or Blocked in the connector's Tools tab, for the whole organization.
Claude's Tool access setting in the same + menu (Auto, Always available or On demand) decides when Claude loads the connector's tools. Auto is fine for this work.
Prompts for field service clients
These prompts ask Claude to explain as well as list: to read both systems and write what a client owner needs to hear. Name the company, and say "do not change anything" while you are checking. Bright Path Plumbing is a fictional business.
Deposits against paid invoices
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 with the deposits in the books and list the days that do not match, with your best guess at the cause.
Estimates that never became jobs
List Housecall Pro estimates scheduled in September and October 2026 with their option totals and approval status. For the approved ones, check whether a job exists for the same customer, and list the approved estimates with no job.
A note for the owner
Using the Housecall Pro invoices and the books for October 2026, write a short note to the owner of Bright Path Plumbing: revenue invoiced, collected and still open, and the three differences between Housecall Pro and the books that need their answer. Plain language, no jargon. Do not send anything.
Job materials against job costs
For Housecall Pro jobs completed in October 2026, list the materials on each job. Compare them with the bills and expenses coded to those jobs or customers in the books, and show jobs with materials but no matching cost.
Turn differences into tasks
Summarize every difference you found in one table: customer, side, document, amount, likely cause. Create a DeepLedger task for each one a person needs to decide.
Creating a task is a write in DeepLedger, so Claude asks first unless you allowed it. Fix each difference where it belongs: in Housecall Pro, in the ledger, or in the sync. More checks are in How do I check Housecall Pro against QuickBooks or Xero?.
Claude Code
The same address works in Claude Code, for anyone who runs the monthly checks from the terminal:
claude mcp add --transport http deepledger https://mcp.deepledger.ai/mcp
Then run /mcp inside Claude Code to sign in to DeepLedger. The Claude Code guide covers the rest.
Troubleshooting
| What you see | What to do |
|---|---|
| Add custom connector is missing | On Team or Enterprise, an owner adds DeepLedger first. On Free, the one custom connector may already be used. |
| The connector will not connect | Claude connects from Anthropic's cloud, not your computer, so the address must be the public https://mcp.deepledger.ai/mcp with no other port. Remove the connector, add it again and sign in again. |
| Claude answers without DeepLedger | Turn DeepLedger on under + → Connectors for that chat, or name it in the prompt. |
| Claude 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. |
| Housecall Pro needs reconnecting | The key was deleted or no longer works. Generate a new Read-only key and paste it on the company's Connections tab. |
| A location's jobs are missing | A Housecall Pro key reaches its own location and the locations beneath it. Ask Claude to list the company's locations and read the missing one by name. |
| Housecall Pro asks DeepLedger to slow down | Claude says so and when to try again. Ask for a narrower date range or one customer. |
Is it safe?
- Each member signs in as themselves. On Team and Enterprise, the connector is shared but the DeepLedger login is not: members reach only their assigned companies, while owners and admins see every company.
- Read only in DeepLedger. Whatever the Housecall Pro key would allow, DeepLedger only sends it read requests, to a fixed list of routes. Generating the key as Read-only adds 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. To stop Claude everywhere, remove DeepLedger under Customize → Connectors or revoke the grant under Settings → Connected apps in DeepLedger.
Frequently asked questions
How do I connect Housecall Pro to Claude?
Connect Housecall Pro to the company in DeepLedger with a Read-only API key. In Claude, open Customize, then Connectors, select + Add, then Add custom connector, paste https://mcp.deepledger.ai/mcp and sign in with your DeepLedger account. Turn DeepLedger on in a chat and ask for Housecall Pro data.
Which Claude plans can add DeepLedger?
Anthropic offers custom connectors on Free, Pro, Max, Ultra, Team and Enterprise plans, with one custom connector on Free (as of November 2026). On Team and Enterprise, an owner adds the connector for the organization first, and each member then connects with their own DeepLedger sign-in.
Can Claude change anything in Housecall Pro?
No. Every Housecall Pro tool Claude sees is a read. DeepLedger refuses any request to Housecall Pro that is not a read before it is sent, so Claude has no way to create, edit or delete a customer, job, estimate or invoice there, whatever its tool permissions allow.
Does Claude see customer 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. Text your staff typed into job or line item descriptions comes through as written.
Does it work in the Claude mobile app?
Yes, once added. Anthropic says a connector added on the web or in Claude Desktop is available the next time you sign in on Claude for iOS or Android. Add it on the web or desktop first.
Related guides
- Connect Housecall Pro to your AI agent
- Connect Claude to QuickBooks Online
- Connect Claude to Xero
- Connect Housecall Pro to ChatGPT
See every supported app on AI platforms and integrations.