DeepLedger
Menu

Connect an agent

QuickBooks Web Connector Setup for AI Agents: Steps and Fixes

QuickBooks Desktop reaches an AI agent through QuickBooks Web Connector on the Windows PC. The setup in DeepLedger and on the PC, step by step, and what to do when the PC stops checking in.

Published by DeepLedger10 min read

QuickBooks Desktop has no cloud connection of its own, so an AI agent reaches it through QuickBooks Web Connector, Intuit's Windows program on the PC where the company file lives. You set up the company in DeepLedger, add one connection file to Web Connector with a one-time password, and then Claude, ChatGPT, Gemini, Microsoft Copilot, Grok or your own agent works in the books at the same address you use for QuickBooks Online and Xero.

This guide is for accounting firms, bookkeepers and in-house teams with clients or entities on QuickBooks Desktop Enterprise. It covers what you need, the setup in DeepLedger and on the PC, adding DeepLedger to each AI app, and the fixes for the problems people hit most.

If you are still choosing how to connect Desktop at all, start with QuickBooks Desktop MCP options. For what DeepLedger does on Desktop, see the QuickBooks Desktop MCP page.

What QuickBooks Web Connector does

Intuit's Web Connector setup article describes it as the program that lets web services work with QuickBooks Desktop: you install it on the Windows computer where the company file is saved, then add each service with its own connection file (a .qwc file).

For DeepLedger, the connection file tells Web Connector to check in about every 15 seconds while Auto-Run is on. A check-in with nothing to do does not open QuickBooks, so it costs little. When your AI agent asks for something, the request waits for the next check-in, and QuickBooks answers on the PC.

What that means in practice:

WorkNeeds the PC on?
Lists: accounts, customers and jobs, vendors, items, classesNo. Read from DeepLedger's copy, which says how old it is
Transactions and reports such as profit and loss, balance sheet, trial balance and agingYes. Read from QuickBooks itself when asked
Writes: bills, invoices, payments, journal entries, list changesYes. Refused while the PC is away, never left waiting

Before you start

  • QuickBooks Desktop Enterprise, US edition. Pro, Premier, Mac and the Canadian and UK editions are not supported.
  • The Windows PC where the company file lives, with QuickBooks Web Connector installed. Intuit's article above has the download.
  • The QuickBooks Admin sign-in for the company file. QuickBooks asks the Admin to allow access the first time.
  • A DeepLedger account. The trial needs no card. QuickBooks Desktop is priced per company; see pricing.
  • Access in DeepLedger to set up the company's connections. Getting a new password later is for an owner or admin of your firm.

A DeepLedger company uses one accounting software at a time. If the company is connected to QuickBooks Online, disconnect it first (if that connection has stopped working, reconnect it, then disconnect). A company that has used Xero cannot switch to QuickBooks Desktop; add a new company for the Desktop file.

Step 1: Set up the company in DeepLedger

  1. In DeepLedger, open Companies and choose Add company. Under "Which accounting software does it use?" choose QuickBooks Desktop. For an existing company, open it instead.
  2. Set up QuickBooks Desktop. Open the company's Connections tab and select Set up QuickBooks Desktop. Copy the password DeepLedger shows once. DeepLedger does not keep a copy of the password and cannot show it again. It is not your DeepLedger password and not your QuickBooks password.
  3. Download the connection file. Select Download the connection file and move it to the Windows PC where QuickBooks Desktop runs. The file is named after the company, such as DeepLedger-Harbour-Supply.qwc.

Step 2: Add DeepLedger to QuickBooks Web Connector

On the PC:

  1. Open the company file. On the Windows PC where QuickBooks Desktop is installed, open the company file, signed in as the QuickBooks Admin.
  2. Open QuickBooks Web Connector. Open QuickBooks Web Connector: in QuickBooks choose File, then App Management, then Update Web Services. You can also open it from the Windows Start menu.
  3. Add the connection file. Choose "Add an application" and pick the connection file you downloaded from DeepLedger.
  4. Allow access. QuickBooks asks whether to allow access. Choose "Yes, always; allow access even if QuickBooks is not running", then continue.
  5. Enter the password. Back in Web Connector, type the password DeepLedger showed you into the Password box next to the DeepLedger entry, and choose to save it when asked.
  6. Update Selected. Tick the box next to the DeepLedger entry and choose "Update Selected".

The entry is named DeepLedger - followed by the company's name, so a PC that holds several companies' connections tells them apart. Turn Auto-Run on for the entry so it keeps checking in on its own.

Back in DeepLedger, the card moves from Waiting for the first connection to Connected, with the company file's name and when the PC last checked in.

Step 3: Add DeepLedger to your AI app

The address is the same for every product: https://mcp.deepledger.ai/mcp. If you already use DeepLedger for QuickBooks Online or Xero clients, skip this step: the same connector reaches the Desktop company. If the AI app asks you to sign in again, allow it.

  • Claude: open Customize → Connectors, select + Add, then Add custom connector. Name it DeepLedger, paste the address, keep Sign in now, choose Register automatically, select Add, then sign in with your DeepLedger account and choose Allow.
  • ChatGPT: go to chatgpt.com/plugins, select +, then Add custom MCP server. Name it DeepLedger, enter the address, choose OAuth, select Create as a plugin, install it and sign in with your DeepLedger account.
  • Gemini: on gemini.google.com on a computer, open Settings, then Connected Apps, and under Custom apps add the address. Sign in with your DeepLedger account and select Connect.
  • Grok: open grok.com/connectors, choose New Connector, then Custom, paste the address and sign in with your DeepLedger account.
  • Microsoft Copilot Studio: in your agent, go to Tools, add a Model Context Protocol tool with the address, and authenticate with a personal DeepLedger API key (Settings → API keys in DeepLedger). The Copilot guide has every step.
  • Cursor, Claude Code and your own agents: any client that supports remote MCP servers can use the same address.

Then check the connection:

Using DeepLedger, which company am I in? Switch to Harbour Supply and tell me when the QuickBooks Desktop PC last checked in.

What to ask first

Start with reads, and check the first answers against QuickBooks.

Show the profit and loss for October 2026 for Harbour Supply, accrual basis.

List unpaid bills due in the next 14 days, by vendor.

Show AR aging as of today and list customers more than 60 days overdue.

When you are ready to write, ask for a dry run first. It runs every check and shows exactly what would be sent, and writes nothing:

Do a dry run of a bill from Pacific Paper for $1,240 dated November 18, 2026, coded to Office Supplies. Show me what would be sent.

Before any write, DeepLedger checks that the PC is connected, refuses anything dated on or before the company's closing date, looks for a duplicate (a second one goes through only after you confirm it) and refuses a transfer between bank accounts. Read-only members cannot write.

Troubleshooting

These are the states the Connections card reports, in its own words, with the fix. Apart from the first, the card's badge reads Needs attention and the line below it names the problem.

The card saysWhyWhat to do
Waiting for the first connectionThe PC has not finished its first check-inFinish Step 2 on the PC, including the password and "Update Selected".
The PC last checked in some time agoThe PC is off or asleep, has no internet, or Web Connector is closed. A new password also keeps it out until it is typed inTurn the PC on, open Web Connector, tick the DeepLedger entry, turn Auto-Run on and choose "Update Selected".
The PC could not open QuickBooksQuickBooks is closed without permission to open by itself, a message window is waiting for an answer, or the file is in use in a way that keeps other programs outOpen QuickBooks and the company file, close any message windows, then choose "Update Selected".
A different company file was open in QuickBooksThe connection belongs to one company file, and another was open, or the file was moved or renamedOpen the right company file, then choose "Update Selected". If the company now uses a different file, disconnect and set up again.
The last check-in from the PC did not finishSomething went wrong the last time the PC checked in, so nothing was read or changedChoose "Update Selected" in Web Connector. If it stays, contact DeepLedger support.

A connection counts as quiet when the PC has not checked in for 15 minutes.

The password is lost. An owner or admin of your firm can get a new one on the company's Connections tab. Type it into the Password box in Web Connector; the old one stops working.

The AI agent says the lists are old. The PC was off for a while. Turn it on with Web Connector running, or ask the AI agent to refresh the lists.

A write was refused. Read the reason: the PC was away, the date is on or before the closing date, a possible duplicate needs your confirmation, or the lists need a refresh first. Nothing was written.

What the AI agent does not do on Desktop

  • It never writes payroll, pay rates, employees, tax ids, card or bank account numbers, or opening balances.
  • DeepLedger's copy of your lists keeps no card numbers, social security numbers, birth dates or pay from customer and employee records. Bank account numbers and tax ids are kept as their last four characters.
  • On a QuickBooks Desktop company, the AI agent does not yet use the AI Brain, skills, Documents, reconciliation, DeepLedger's custom reports or the month-end close tools.

Frequently asked questions

What is QuickBooks Web Connector?

QuickBooks Web Connector is Intuit's free Windows program that lets a web service exchange data with a QuickBooks Desktop company file. It runs on the PC where the company file lives and checks in with the service on a schedule, which is how DeepLedger reaches QuickBooks Desktop for your AI agent.

Does the PC need to stay on for the AI agent to work?

For most work, yes. Transactions and reports are read from QuickBooks itself, and writes go to QuickBooks, so the PC must be on with Web Connector running. When it is off, the AI agent can still read the lists from DeepLedger's copy, and it says how old they are.

Where do I get the Web Connector password?

DeepLedger shows it once, on the company's Connections tab, right after you select Set up QuickBooks Desktop. It is a new password made only for this connection, not your DeepLedger or QuickBooks password. If it is lost, an owner or admin of your firm can get a new one on the same tab.

Can one PC connect several QuickBooks Desktop companies?

Yes. Each DeepLedger company has its own connection file, named after the company, and each appears in Web Connector as its own DeepLedger entry. Open the right company file for the entry you update.

Which QuickBooks Desktop editions work?

QuickBooks Desktop Enterprise, US edition. Pro, Premier, Mac and the Canadian and UK editions are not supported.

See every supported app on AI platforms and integrations.

Ready to get started?

Connect QuickBooks and try your first task with an AI agent.

Create an Account

With your permission, Google Analytics measures visits to our public website and blog. Essential cookies work either way. Change your choice in Cookie settings. Privacy policy