Grok Bot 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 Grok Bot as a Remote HTTPS custom connector, and your Bots can read jobs, estimates, invoices and payments next to the company's QuickBooks or Xero books. The Housecall Pro side is read only.
Grok Bot is a separate xAI product from Grok chat. xAI describes it as Bots that work for you on a persistent cloud computer, and says it is not the same as Grok on grok.com, so add DeepLedger in Grok Bot itself, even if Grok chat already has it. For Grok chat, see Connect Housecall Pro to Grok.
What Grok Bot adds for bookkeeping is files: you can attach a bank statement export or a spreadsheet to a request, and the Bot works through it next to what it reads from Housecall Pro and the books.
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.
Who can use Grok Bot?
From xAI's Grok Bot get started guide, as of November 2026:
| Access | Includes Grok Bot |
|---|---|
| The X Subscription | Premium, Super and Ultra, for an individual or a team seat |
| Legacy Cursor plans | Every paid individual plan and self-serve Cursor Teams |
| Linked Grok subscription | SuperGrok, SuperGrok Plus, SuperGrok Heavy or X Premium+ |
| Grok Business | A seat on a self-serve Grok Business plan |
The desktop app runs on macOS, Windows and Linux; there are also iPhone and Android apps. Grok Bot signs in with your Cursor account, or with Sign in with Grok for a Grok Business seat. On a team, the team's Cursor MCP policy decides which connectors members may add.
What a Bot can read in Housecall Pro
| Housecall Pro area | 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, appointments |
| Estimates | Options, totals and approval status |
| Invoices | Amount, amount due, taxes, discounts and payments by method, amount and date |
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 the Bot.
Before you start
- Housecall Pro with API keys. Housecall Pro lists API keys with its MAX plan, and its API page names XL as well (as of November 2026). Only an admin can 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 with the client company added, usually with QuickBooks Online or Xero connected, and an owner or admin who can paste the key. The trial needs no card.
- Grok Bot access from the table above, and the desktop app for the setup.
How do I connect Housecall Pro to Grok Bot?
- 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 the Grok Bot desktop app, open Connect apps and choose Add a custom connector at the bottom. Enter the Name DeepLedger and pick the Type Remote HTTPS.
- Enter the server URL. Enter https://mcp.deepledger.ai/mcp as the Server URL, leave HTTP headers and Client ID empty, and choose Add plugin.
- Authenticate. When DeepLedger shows Needs auth, choose Authenticate and sign in with your DeepLedger account, not your Housecall Pro login. Confirm DeepLedger appears under Installed.
- Check the connection. In a Bot chat, type @, attach DeepLedger and ask: Which company am I in? Read the Housecall Pro company and tell me its name and time zone.
DeepLedger supports OAuth with dynamic client registration, so the Client ID field stays empty. These labels follow xAI's computer and apps guide.
Or ask the Bot. xAI says a Bot can add an MCP server that is not in the catalog by URL. In a Bot chat, say "Add a custom MCP server called DeepLedger at https://mcp.deepledger.ai/mcp", confirm, then choose Authorize or Authenticate on the Connect card and sign in to DeepLedger. Either route works.
Read the business name the Bot reports. A name you do not know means the key came from another Housecall Pro account; an owner or admin disconnects it on the Connections tab and pastes the right one.
Know that apps are account-wide
xAI says a connected app is available to every Bot you run. Once DeepLedger is connected, any of your Bots can reach the companies your DeepLedger user can open, the books included. A teammate's Team Bot asks before it uses your accounts. DeepLedger's ledger tools include writes, and a Bot shows an approval card before an action that needs your OK, so read the target and values on each card before you approve.
If none of your Bots should reach client books for a while, remove DeepLedger from Connect apps and add it again when you need it.
Work through a bank file with a Bot
Attach the bank export, then ask. A CSV or Excel file of the month's bank lines works well. Bright Path Plumbing is a fictional business.
@DeepLedger In Bright Path Plumbing, do not change anything. I attached the operating account's October 2026 bank export. Read Housecall Pro invoices paid in October 2026 with each payment's method, amount and date. Match the card payments to the bank deposits by day, allowing for fees, and match cash and checks one by one. Return a spreadsheet with three tabs: matched, Housecall Pro payments with no deposit, and deposits with no Housecall Pro payment.
Using the same bank file, read the deposits recorded in the books for October and tell me which bank deposits are not in the books yet.
List Housecall Pro jobs scheduled in October 2026 that are completed and still show an outstanding balance. Add them as a fourth tab with job, customer city, total and balance.
The Bot returns the file in the chat for you to check and pass to the reviewer. The bank file is yours to share; decide with your client whether it belongs in Grok Bot before you attach it. For more prompts, see How do I check Housecall Pro against QuickBooks or Xero?.
Troubleshooting
The connector cannot be saved. Your team admin's MCP policy blocks it. Ask the admin to allow https://mcp.deepledger.ai/mcp on the Cursor dashboard's Plugins & MCPs page.
DeepLedger shows Added but the Bot says it is missing. Added means installed, not signed in. Open DeepLedger in Connect apps and choose Authenticate if it shows Needs auth or Disconnected.
Sign-in does not finish. Choose Reconnect on the app, or Reopen on the in-chat card, and finish within about 10 minutes.
DeepLedger shows Disabled by team admin. Ask your Cursor team admin to turn it on.
The Bot 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. Removing DeepLedger from Grok Bot will not fix this.
Is it safe?
- Your login, your companies. The connector signs in to DeepLedger as you, so your Bots reach only the companies you are assigned to; owners and admins see every company.
- Read only in DeepLedger. DeepLedger only ever sends Housecall Pro read requests, along a fixed list of routes, even if a Bot asks for more. The Read-only key is a second fence.
- Tokens stay off the Bot's computer. xAI says OAuth tokens are held on Cursor's connector backend and Bots call tools without receiving them.
- Revoking access. Disconnect Housecall Pro on the company's Connections tab, or delete the key in Housecall Pro's API Key Management. To stop every Bot, choose Remove on DeepLedger in Connect apps and revoke the grant under Settings → Connected apps in DeepLedger.
Frequently asked questions
How do I connect Housecall Pro to Grok Bot?
Connect Housecall Pro to the company in DeepLedger with a Read-only API key. In the Grok Bot desktop app, open Connect apps, choose Add a custom connector, name it DeepLedger, pick Remote HTTPS, enter https://mcp.deepledger.ai/mcp and choose Add plugin. Then authenticate with your DeepLedger account.
Is Grok Bot the same as Grok on grok.com?
No. xAI describes Grok Bot as Bots that work on a persistent cloud computer, and says it is not the same as Grok on grok.com. Grok Bot has its own Connect apps list, so add DeepLedger there even if Grok chat already has it.
Which plans include Grok Bot?
xAI lists Premium, Super and Ultra on The X Subscription, paid legacy Cursor plans, a linked SuperGrok, SuperGrok Plus, SuperGrok Heavy or X Premium+ subscription, and a seat on a self-serve Grok Business plan (as of November 2026).
Can Grok Bot change anything in Housecall Pro?
No. A Bot can read Housecall Pro through DeepLedger but cannot change it. DeepLedger passes only read requests to Housecall Pro and refuses the rest before they are sent, so no Bot, yours or a teammate's, can create, edit or delete a customer, job, estimate or invoice there.
Can every one of my Bots use DeepLedger?
Yes. xAI says a connected app is available to every Bot you run, and a teammate's Team Bot asks before it uses your accounts. Remove DeepLedger from Connect apps if a Bot should not reach your companies.
Related guides
- Connect Housecall Pro to your AI agent
- Connect Housecall Pro to Grok
- Connect Grok and Grok Bot to QuickBooks Online
- Connect Housecall Pro to Cursor
See every supported app on AI platforms and integrations.