ChatGPT 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 ChatGPT as a custom MCP plugin, and ChatGPT can read jobs, estimates, invoices and payments next to the company's QuickBooks or Xero books. It cannot change anything in Housecall Pro.
This guide is for accounting firms and bookkeepers who already work in ChatGPT and keep the books for plumbers, electricians, HVAC and cleaning businesses on Housecall Pro. It covers the plan you need, the setup, the permission setting that keeps reads quick, and prompts for the questions field service clients bring every month.
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.
Which ChatGPT plan works with Housecall Pro?
OpenAI decides which plans can add a custom MCP server. As of November 2026, from OpenAI's help article:
| ChatGPT plan | What works with DeepLedger and Housecall Pro |
|---|---|
| Business | Full MCP. Only admins and owners create and publish the plugin for the workspace; members then use it |
| Enterprise, Edu | Full MCP. Admins can let selected members create connections; admins and owners publish |
| Pro | Read and fetch permissions only. Switching between client companies is not a read-only tool, so use a workspace plan for several clients |
| Plus, Free | Not listed by OpenAI for custom MCP servers |
Custom MCP servers are added and used at chatgpt.com. OpenAI says they are web only, so the ChatGPT mobile apps do not reach DeepLedger.
What ChatGPT reads in Housecall Pro
| Housecall Pro area | What ChatGPT can read through DeepLedger |
|---|---|
| Company and lists | Name, time zone and locations; customers, employees, job types, tags, lead sources, price book services, materials |
| Jobs | Customer, service city, status, schedule, totals, outstanding balance; line items, invoices, materials and appointments |
| Estimates | Options, totals and approval status; an option's line items |
| Invoices | Amount, amount due, taxes, discounts and payments (method, amount, date); line items on one invoice |
Amounts come back in dollars. DeepLedger leaves customer and employee email addresses and phone numbers, street addresses, notes, attachments and payment notes 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 API access. Housecall Pro names its MAX plan for API keys, and its API page also lists XL (as of November 2026). A Housecall Pro admin generates 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 in it, usually with QuickBooks Online or Xero connected. An owner or admin pastes the Housecall Pro key. The trial needs no card.
- A ChatGPT plan from the table above, on the web.
How do I connect Housecall Pro to ChatGPT?
- 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 MCP server. Go to chatgpt.com/plugins, select +, then Add custom MCP server. Name it DeepLedger.
- Enter the server URL and choose OAuth. Under Connection, enter the server URL https://mcp.deepledger.ai/mcp and choose OAuth for authentication.
- Create and install the plugin. Read the risk notice, select I understand and want to continue, then Create as a plugin. Install it and sign in with your DeepLedger account.
- Check the connection. In a new chat, type @, pick DeepLedger and ask: Which company am I in? Read the Housecall Pro company and tell me its name and time zone.
You do not need Developer mode. The ChatGPT steps follow OpenAI's custom MCP server guide. Sign in with your DeepLedger account, never your Housecall Pro login. If your workspace already has the DeepLedger plugin for QuickBooks or Xero, skip steps 2 to 4.
Check the business name in the answer. If it is not the client you meant, the key came from another Housecall Pro account: an owner or admin disconnects it on the Connections tab and pastes the right key.
How do I stop ChatGPT asking before each read?
OpenAI treats any tool that is not marked read-only as a write and asks you to confirm it. DeepLedger marks every Housecall Pro tool as read-only, so you can let reads through and keep the prompts for everything else.
On a personal account, such as Pro, open DeepLedger in Settings → Plugins and look at its permissions. OpenAI's permissions article lists Always ask, Allow read actions, Allow low-risk actions and Allow all actions. Allow read actions suits this work: Housecall Pro reads run straight away, and anything that is not marked read-only still asks first.
In a Business, Enterprise or Edu workspace, that setting is not yours to change: workspace policy decides which tools ask, and the approval card offers Deny or Allow once. Ask your workspace admin if every read prompts.
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.
Prompts for field service bookkeeping
Name the company in each prompt and start with "do not change anything" while you are checking. Bright Path Plumbing is a fictional business.
Card deposits for one week
@DeepLedger switch to Bright Path Plumbing. Do not change anything. List Housecall Pro invoices paid from November 2 to November 8, 2026 with each payment's method, amount and date, totalled by day and method. Then show the bank deposits in the books for those days and list any day that does not match.
Card payments often land as one deposit for several invoices, less fees. If the books hold payments in Undeposited Funds first, ask ChatGPT to compare against that account too.
Open invoices against the aging
List Housecall Pro invoices that are open or pending payment, with job, due date and amount due. Show the AR aging in the books as of today. Give me one table by customer with both totals and the difference.
Jobs finished but never invoiced
List Housecall Pro jobs scheduled in October 2026 with status and outstanding balance. For each completed job, list its invoices, and show the completed jobs with no invoice.
Sales tax by invoice
List Housecall Pro invoices created in October 2026 with subtotal, each tax's amount, discounts and total. Compare the tax amounts with sales tax payable in the books for October.
Use the tax amount, not the rate: a tax rate comes through exactly as Housecall Pro sends it.
The next client
Now do the same deposit check for Summit Electric.
DeepLedger moves your active company when you switch, so the next prompt runs there. Check the company name in each answer before you rely on it. Full reconciliation prompts are in How do I check Housecall Pro against QuickBooks or Xero?.
What ChatGPT cannot do with Housecall Pro
- 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, whatever the key allows.
- See contact details. The fields listed above never reach ChatGPT.
- Read another business. Each DeepLedger company connects to its own Housecall Pro account with its own key, and you reach only the companies you are assigned to.
Troubleshooting
The + control or Add custom MCP server is missing. Your plan or workspace settings decide it. On Business, only admins and owners can create the plugin; on Enterprise and Edu, an admin can grant the "Create plugins with MCPs" permission.
ChatGPT answers without DeepLedger. Type @ and pick DeepLedger in that chat, or start a new chat from the plugin.
ChatGPT 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. On a workspace plan, an admin may need to refresh the plugin so its tool list is current.
ChatGPT asks you to sign in again. The DeepLedger sign-in lapsed. Open DeepLedger in Settings → Plugins and connect again with your DeepLedger account; the Housecall Pro key saved in DeepLedger is not affected.
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. Recreating the ChatGPT plugin will not fix this.
A location's jobs are missing. A Housecall Pro key reaches its own location and the locations beneath it. Ask ChatGPT to list the company's locations and read the missing one by name.
Is it safe?
- Each person signs in as themselves. In a ChatGPT workspace, every member connects with their own DeepLedger login and reaches only the companies they are assigned to; owners and admins see every company.
- Two fences on Housecall Pro. DeepLedger sends only read requests, and 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. To stop ChatGPT everywhere, disconnect DeepLedger in Settings → Plugins or revoke the grant under Settings → Connected apps in DeepLedger.
Check your workspace's data settings and your firm's policy before using client data in any AI app.
Frequently asked questions
How do I connect Housecall Pro to ChatGPT?
Connect Housecall Pro to the company in DeepLedger with a Read-only API key. Then in ChatGPT on the web open Plugins, select the plus button and Add custom MCP server, enter https://mcp.deepledger.ai/mcp with OAuth, create it as a plugin and sign in with your DeepLedger account.
Which ChatGPT plan do I need?
A Business, Enterprise or Edu workspace for the full workflow. OpenAI gives those plans full MCP support and gives Pro read and fetch permissions only. Switching between client companies is not a read-only tool, so a firm with several clients needs one of the workspace plans. Plan rules change, so check OpenAI's current page.
Can ChatGPT change anything in Housecall Pro?
No. ChatGPT reaches Housecall Pro only through DeepLedger, and DeepLedger sends Housecall Pro nothing but read requests. Any other request is refused before it leaves DeepLedger, so a customer, job, estimate or invoice in Housecall Pro cannot be created, edited or deleted from ChatGPT.
Will ChatGPT ask before every Housecall Pro read?
It depends on the account. DeepLedger marks every Housecall Pro tool as read-only, and OpenAI respects that mark. On a personal account, the plugin's Allow read actions permission lets reads run without a prompt; in a Business, Enterprise or Edu workspace, workspace policy decides which tools ask.
Can I use it in the ChatGPT mobile app?
No. OpenAI says custom MCP servers are web only. Add DeepLedger and run the Housecall Pro prompts at chatgpt.com.
Related guides
- Connect Housecall Pro to your AI agent
- How to connect ChatGPT to QuickBooks Online
- How to connect ChatGPT to Xero
- Connect Housecall Pro to Claude
See every supported app on AI platforms and integrations.