Grok 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 as a custom connector at grok.com/connectors, and Grok can read jobs, estimates, invoices and payments next to the company's QuickBooks or Xero books. Grok cannot change anything in Housecall Pro.
This guide covers Grok chat on grok.com, the extra admin step on Grok Business and Enterprise, and the xAI API for people who build their own checks. Grok Bot is a different product with its own setup: see Connect Housecall Pro to Grok Bot. Already using Grok with QuickBooks? The Grok and QuickBooks guide covers the ledger side.
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 Grok route do you need?
| You use | Route | Who sets it up |
|---|---|---|
| Grok on grok.com, personal account | Custom connector at grok.com/connectors | You |
| Grok Business or Enterprise | The same connector, added first in the xAI console | A team admin, then each member |
| Your own script or agent | xAI Responses API with a remote MCP tool | Whoever writes the code |
| Grok Bot | A custom MCP server added in the bot | See the Grok Bot guide |
All four reach the same DeepLedger address and the same Housecall Pro data.
What Grok can read in Housecall Pro
Through DeepLedger, Grok reads the Housecall Pro company (name, time zone, locations) and its lists, 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.
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, and never sends it to Grok.
Before you start
- A Housecall Pro plan that includes the API. Housecall Pro points to MAX for API keys, and XL also appears on its API page (as of November 2026). You need a Housecall Pro admin to generate one.
- 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 holding the company, most often with QuickBooks Online or Xero connected, and a DeepLedger owner or admin to paste the key. The trial needs no card.
- Grok. xAI's connector documentation says connectors are available to all Grok users (as of November 2026).
How do I connect Housecall Pro to Grok?
- 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.
- Open Grok's connectors. Open grok.com/connectors while signed in to Grok and choose New Connector, then Custom.
- Paste the address and sign in. Paste https://mcp.deepledger.ai/mcp and complete the sign-in with your DeepLedger account, not your Housecall Pro login.
- Check the connection. In a new conversation, ask: Using DeepLedger, which company am I in? Read the Housecall Pro company and tell me its name and time zone.
There is no company to pick during sign-in; you choose the company in the conversation. If DeepLedger is already a Grok connector for QuickBooks or Xero, skip steps 2 and 3.
If Grok names a business you did not expect, the key was generated in another Housecall Pro account. Disconnect it on the company's Connections tab and paste the key from the right account.
Grok Business and Enterprise
xAI's connector management guide says a team admin must add a connector in the console before members can connect. The admin opens the xAI console, goes to Grok Business → Connectors, selects + Add Connector, then Other, and enters https://mcp.deepledger.ai/mcp. That needs the Team Read-Write permission. Members then connect from grok.com with their own DeepLedger sign-in, so each person reaches only the companies they are assigned to.
Prompts for Housecall Pro clients
Name the company and start with "do not change anything" while you are checking. Bright Path Plumbing is a fictional business.
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 and list the days that do not match.
Discounts given in a month
List Housecall Pro invoices created in October 2026 with subtotal, discounts and total. Show the ten largest discounts with job and customer city, and the total discount for the month, next to the discounts or sales returns line in the books.
Deleted jobs
List Housecall Pro jobs scheduled in October 2026, including deleted jobs, and mark the deleted ones. Do any deleted jobs have an invoice that still appears in the books?
Deleted jobs are left out of a job list unless you ask for them, so ask when you are chasing a revenue difference.
Cash and checks against deposits
List Housecall Pro invoices paid in October 2026, grouped by payment method, with the total for each method. For the cash and check payments, find the matching deposits in the books and list payments with no deposit.
Card payments usually arrive in batches less fees, so they need the day-by-day check above. Cash and checks can be matched one by one.
More reconciliation prompts are in How do I check Housecall Pro against QuickBooks or Xero?.
Use the xAI API
For a check you run from your own code, xAI's Responses API takes a remote MCP tool. Create a DeepLedger API key under Settings → API keys → Create key and keep it in an environment variable. The tool entry looks like this:
{
"type": "mcp",
"server_url": "https://mcp.deepledger.ai/mcp",
"server_label": "deepledger",
"authorization": "<your DeepLedger API key, read from an environment variable>",
"allowed_tools": ["connections", "describeTool", "callReadTool"]
}
The authorization value is sent to DeepLedger as the Authorization header. Field names follow xAI's remote MCP documentation.
Keep allowed_tools to those three. xAI does not support require_approval in the Responses API, so nothing asks before a tool runs. callReadTool runs reads only, in Housecall Pro and in the books, and refuses any call that would change data; connections and describeTool are read only too. companies is left out because it can switch the active company that your other AI apps share, so for a check on one client, create the key for One company.
allowed_tools limits what the request offers the model; it is not a permission on the key. The DeepLedger key acts as the person who created it and has no read-only setting of its own.
Troubleshooting
No Custom option at grok.com/connectors. On Business and Enterprise, an admin must add the connector in the console first.
Grok 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 key was deleted or no longer works. Generate a new Read-only key and paste it on the company's Connections tab. Removing and re-adding the Grok connector will not fix this.
The answer is for the wrong company. Ask "which company am I in?" and switch. Another AI app may have moved your active company.
A filter seems to be ignored. It is not: DeepLedger refuses a filter that does not apply to a record type before anything is sent. Ask Grok what the error said and narrow the question.
The API returns an authentication error. The authorization field must carry a DeepLedger key starting with dl_live_, not your xAI key.
Is it safe?
- Members sign in as themselves. On Grok Business and Enterprise, the admin adds the connector once, but each member's DeepLedger login decides what they reach: only their assigned companies, or every company for owners and admins.
- Read only in DeepLedger. Requests to Housecall Pro are reads to a fixed list of routes, whatever the key permits; a Read-only key 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 Grok everywhere, remove the connector in Grok and revoke the grant under Settings → Connected apps in DeepLedger.
Frequently asked questions
How do I connect Housecall Pro to Grok?
Connect Housecall Pro to the company in DeepLedger with a Read-only API key. Then open grok.com/connectors, choose New Connector, then Custom, paste https://mcp.deepledger.ai/mcp and sign in with your DeepLedger account.
Do I need a paid Grok plan?
No paid plan is named for this. xAI says connectors are available to all Grok users (as of November 2026). On Grok Business and Enterprise, a team admin adds the connector in the xAI console before members can connect.
Can Grok change anything in Housecall Pro?
No. Grok's DeepLedger connector reads Housecall Pro and cannot write to it. DeepLedger refuses every request to Housecall Pro except reads before anything is sent, so no customer, job, estimate or invoice there can be created, edited or deleted from Grok, in chat or through the API.
Is Grok Bot set up the same way?
No. Grok Bot is a separate xAI product with its own way to add an MCP server. See the Grok Bot guide for Housecall Pro.
Can I call DeepLedger from the xAI API?
Yes. xAI's Responses API takes a remote MCP tool with server_url set to https://mcp.deepledger.ai/mcp and a DeepLedger API key in the authorization field. The Responses API does not ask before a tool runs, so set allowed_tools to connections, describeTool and callReadTool, DeepLedger's read tools.
Related guides
- Connect Housecall Pro to your AI agent
- Connect Housecall Pro to Grok Bot
- Connect Grok to Xero
- Grok QuickBooks bookkeeping prompts
See every supported app on AI platforms and integrations.