To create a QuickBooks Online invoice with Grok, connect Grok to DeepLedger's hosted MCP server, ask Grok for an invoice proposal, approve the exact fields in the chat, then check the saved invoice in QuickBooks before anyone sends it. DeepLedger's invoice tool records the invoice in the QuickBooks company you name. This guide is for bookkeepers and business owners who use Grok chat; the company, customer and amounts below are fictional.
If Grok is not connected yet, first connect Grok to QuickBooks Online. That guide also covers Grok Bot and the xAI API.
How do I create a QuickBooks invoice with Grok?
- Connect Grok to DeepLedger. In Grok, open grok.com/connectors, choose New Connector, then Custom, paste
https://mcp.deepledger.ai/mcpand sign in to DeepLedger. - Confirm the company. Ask Grok which company you are in, and switch by name if it is the wrong one.
- Gather the invoice details. Collect the customer, item, quantity, rate, dates, sales tax treatment and billing email from the agreed work.
- Ask for a proposal. Ask Grok to read the company's AI Brain income rules, look up the customer and item, check open invoices and show the proposed invoice without creating anything.
- Approve the exact invoice. Reply with the fields you approve and tell Grok to create one invoice in the named company and not email it.
- Check the saved invoice. Open the invoice in QuickBooks Online and compare every field with your source.
- Send it as a separate decision. Send the checked invoice from QuickBooks, or ask Grok to email it after you confirm the stored address.
Each step is explained below, with prompts you can copy.
How does Grok reach QuickBooks Online?
Grok reaches QuickBooks Online through a hosted MCP server such as DeepLedger. The steps below apply to DeepLedger only.
Step 1: Connect Grok and confirm the company
- In DeepLedger, open Companies, select the company and open its Connections tab. If QuickBooks is not connected, choose Connect to QuickBooks and have a QuickBooks admin complete Intuit's sign-in.
- In Grok, open grok.com/connectors, choose New Connector, then Custom, and enter the address:
https://mcp.deepledger.ai/mcp
- Sign in to DeepLedger when Grok asks. Business and Enterprise teams need an admin to provision connectors first.
- Start every invoice session by checking the company:
Using DeepLedger, which company am I in? List the companies I can access. Do not create or change anything.
If the active company is wrong, ask Grok to switch by name and read back the company it reports. Your active company is shared across all your connected AI clients, so a switch in another session moves this one too. See working in several QuickBooks companies.
DeepLedger adds a second check at write time. Every write must name its company. If the company is missing or differs from the active company, DeepLedger refuses the write and nothing is saved, and Grok has to ask you which company to use.
Step 2: Gather what the invoice needs
DeepLedger's invoice tool needs a customer, an invoice date and at least one line. Each line should name an existing product or service item. Without one, QuickBooks puts a default item and its income account on the line.
| Detail | Fictional example | What to check |
|---|---|---|
| Company | Harbor Design Co. | Is this the company Grok reported? |
| Customer | Maple Row Dental | Does this exact customer exist? |
| Item | Brand design (service) | Which existing item and income account? |
| Quantity and rate | 6 hours at $150 | Does it match the agreed work? |
| Invoice and due dates | November 2 and December 2, 2026 | Are these the agreed terms? |
| Subtotal | $900 | Is quantity times rate correct? |
| Sales tax | Not decided yet | What applies to this customer and service? |
| Billing email | billing@maplerowdental.example | Which address should receive the invoice? |
Leave tax open until Grok has read the company profile, which reports whether sales tax is turned on. Do not let Grok assume "no tax" to finish the example.
Set the billing email on the invoice itself. QuickBooks does not copy the customer's email onto an invoice created through the API, and it sends to the address stored on the invoice unless you give a different recipient when you send.
If your firm keeps income rules for this client in DeepLedger's AI Brain (for example, "design retainers use the Brand design item"), tell Grok to read them. Grok reads the AI Brain when you ask, not on its own.
Step 3: Ask for a proposal before any write
Using DeepLedger, confirm the active company is Harbor Design Co.
Read Harbor Design Co.'s AI Brain income rules before choosing the
invoice item. Look up the customer Maple Row Dental and the brand
design service item. Check for open invoices for this customer.
Prepare an invoice proposal: 6 hours of brand design at $150 per
hour, invoice date November 2, 2026, due December 2, 2026, billing
email billing@maplerowdental.example. Show the matched customer and
item with their QuickBooks IDs, each line, the subtotal, the sales tax
treatment, the billing email and the total. If the customer or item
is ambiguous, ask me, or create a DeepLedger task describing what is
missing. Do not create, send or change anything yet.
Everything Grok does here is a read: the AI Brain, the company profile, the customer and item lookups, and a list of the customer's open invoices. If an open invoice already covers this work, stop. DeepLedger's invoice tool tells the model to check open invoices before creating one, but that is guidance to the model, not a block, so ask for it in the prompt.
A similar customer name is not a match. If Grok finds two candidates, pick one by its ID. If nobody can decide today, a task in the company's Tasks tab keeps the question in front of the person who can answer it.
Step 4: How does approval work in Grok?
xAI's connector documentation says Grok can use a connector's tools automatically when your question relates to that service. It does not describe a confirmation screen before a tool call, including for custom connectors like DeepLedger. On the xAI API, the remote MCP documentation says the require_approval parameter is not supported.
DeepLedger's invoice tool has no approval gate either. So the approval is your next message, and the proposal prompt only asks Grok to wait for it. That is an instruction Grok should follow, not an enforced control. Reply with the exact invoice you approve:
Approved. Create one invoice in Harbor Design Co. for Maple Row
Dental: one line, brand design service item, quantity 6, rate $150,
no sales tax, invoice date 2026-11-02, due date 2026-12-02, billing
email billing@maplerowdental.example. Do not email it, do not mark it
to send later, and do not record a payment. Then read the invoice
back from QuickBooks.
Replace "no sales tax" with the treatment you confirmed. If any field differs from the proposal you read, do not approve it.
Grok then calls DeepLedger's qbInvoice tool. Before writing, DeepLedger refuses impossible dates such as February 30, because QuickBooks would otherwise book the invoice on today's date. After writing, it checks selected fields it sent, such as the invoice date, due date, terms, billing email and tax code, against what QuickBooks stored. On a new invoice, a checked field QuickBooks did not keep comes back as a warning. On an update, it fails with NOT_APPLIED and lists the fields, although the rest of the update was saved.
The result also returns the invoice ID and number, customer, lines, tax, total and open balance. The customer and the line amounts, quantities, rates and descriptions are returned, not compared, so check those yourself.
Step 5: Check the saved invoice in QuickBooks
Open the invoice in QuickBooks Online and compare it with your source:
- Company and customer
- Invoice number and ID
- Invoice date, due date and terms
- Billing email
- Item, quantity, rate and line description
- Sales tax, total and open balance
A success message from Grok is not the check. Read the stored fields. To change an invoice that already exists, give Grok the invoice ID. Lines sent on an update replace every stored line, so a partial list deletes the rest.
Step 6: Send the invoice as a separate decision
Recording an invoice sends nothing to the customer. Storing an email address on it sends nothing either. Setting NeedToSend only puts it in QuickBooks' send later list for a person to send.
You can send the checked invoice from QuickBooks yourself. Or ask Grok:
Using DeepLedger, find invoice 1047 for Maple Row Dental and give me its QuickBooks ID. Show the billing email stored on it and the total. Wait for my confirmation, then email that invoice ID through QuickBooks to the stored address.
The email tool needs the invoice's QuickBooks ID, not the invoice number on the form. DeepLedger's email tool is the only one that emails a customer, and it sends through QuickBooks. DeepLedger asks for confirmation before the send only in AI clients that support MCP confirmation requests. We have not confirmed whether Grok does, so treat the wait in the prompt as an instruction, not a lock.
| Before you approve a send | Why it matters |
|---|---|
| The address stored on the invoice | Sending to a different address permanently replaces the stored email. |
| Whether it was sent already | An email cannot be unsent, and every call sends again. |
| The invoice status | Voided invoices are refused. |
| Payment | Sending an invoice is not a payment. Record payments when the money arrives. |
DeepLedger reports the send as delivered only when QuickBooks returns a delivery time. Nothing is sent or chased on a schedule: a reminder goes out only when you ask for one. For chasing late invoices, use the overdue invoices workflow for Grok.
Troubleshooting
Grok cannot find the customer or item. QuickBooks matches exact records, and a similar name is not the same customer. Ask Grok to list customers or items containing a word from the name, then choose one by its ID. Creating a new customer is a separate decision; approve it on its own.
DeepLedger refused the write and Grok asks which company. The company write guard found that the write did not name the active company. Confirm the company in the chat, then repeat the approval with the company name in it. Nothing was saved by the refused call.
The request timed out or the reply was unclear. Search QuickBooks for the invoice by customer, date and amount before asking again. Repeating the request can create a duplicate. The duplicate invoice checklist explains how to look.
The send failed with NO_EMAIL_ADDRESS. The invoice has no stored email, so the tool sent nothing. Add the address to the invoice, or give Grok an address to send to.
Grok says it has no invoice tool. Grok is holding an older copy of the tool list, or the connector is off in this conversation. Start a new conversation, confirm the DeepLedger connector is enabled, and ask "which company am I in?" again.
Frequently asked questions
Can Grok create invoices in QuickBooks Online?
Yes. Grok creates QuickBooks Online invoices through DeepLedger's hosted MCP server, which you add in Grok at grok.com/connectors with the address https://mcp.deepledger.ai/mcp. Grok prepares the invoice, you approve it in the chat, and DeepLedger's invoice tool records it in the company you named.
Does Grok ask for approval before it creates the invoice?
Not as an enforced step. xAI's connector documentation does not describe a confirmation before a tool call, and DeepLedger's invoice tool has no approval gate. Asking Grok to show the proposal and wait for your reply is an instruction Grok should follow, not a control that blocks the write, so check the saved invoice in QuickBooks.
Does creating the invoice email it to the customer?
No. DeepLedger's invoice tool records the invoice and sends nothing. Emailing is a separate tool. DeepLedger asks for confirmation before a send only in AI clients that support MCP confirmation requests; otherwise your instruction is the only thing stopping Grok from calling it. The NeedToSend status only puts the invoice in QuickBooks' send later list.
What stops Grok from creating the invoice in the wrong company?
DeepLedger's company write guard. Every write must name its company, and if the company is missing or differs from the active company, DeepLedger refuses the write and nothing is saved. Grok then has to ask you which company to use.
What should I do if Grok's invoice request times out?
Search QuickBooks Online for the invoice by customer, date and amount before asking Grok again. An unclear reply does not prove the write failed, and repeating the request can create a duplicate invoice.
Can Grok cancel an invoice it created?
Yes, by voiding it with your confirmation. DeepLedger has no delete tool, so a voided invoice stays in QuickBooks for the audit trail. To correct an invoice instead, give Grok the invoice's QuickBooks ID and send every line you want to keep, because lines sent on an update replace all stored lines.
Related guides
- Connect Grok to QuickBooks Online: chat connector, Grok Bot and xAI API setup
- Five Grok bookkeeping prompts for bills, expenses, invoices and deposits
- Review overdue QuickBooks invoices with Grok
- Create a QuickBooks invoice with Claude
- QuickBooks MCP server guide
See every AI app DeepLedger works with on AI Platforms & Integrations.