Cursor connects to QuickBooks Online through DeepLedger's remote MCP server: add https://mcp.deepledger.ai/mcp to Cursor's mcp.json and sign in with your DeepLedger account. Your QuickBooks company connects to DeepLedger first, so Cursor needs no QuickBooks developer app or local server. This guide covers the OAuth route, an API-key route for setups without a browser, and a first report check.
Add this entry to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project), keeping any servers already there:
{
"mcpServers": {
"deepledger": {
"url": "https://mcp.deepledger.ai/mcp"
}
}
}
The file locations, ${env:NAME} interpolation, Streamable HTTP transport and OAuth support are documented in Cursor's MCP guide.
What are you connecting?
DeepLedger runs a hosted QuickBooks MCP server. An admin connects each QuickBooks Online company to DeepLedger once, through Intuit's own sign-in. Cursor then signs in to DeepLedger as you and reaches the companies you can access. Cursor never sees Intuit credentials.
| OAuth sign-in | DeepLedger API key | |
|---|---|---|
| Best for | Cursor on your own computer | Setups where browser sign-in isn't possible |
What you add to mcp.json | The URL only | The URL and an Authorization header |
| Where the secret lives | Cursor's stored sign-in | An environment variable, DEEPLEDGER_API_KEY |
| Acts as | You | The person who created the key |
| Revoke | Settings → Connected apps in DeepLedger | Settings → API keys in DeepLedger |
The same address serves Xero and Stripe (read only, for reporting) for companies that connect them; see the Xero MCP guide.
It also serves Bill.com for companies that connect it with your own BILL credentials.
Before you start
- A DeepLedger account with access to the intended QuickBooks Online company.
- Cursor desktop. On Enterprise, admins can restrict which MCP servers and tools are allowed; Cursor's pricing page lists MCP controls under Enterprise (as of November 2026).
- A demo company for the first run.
How do I connect Cursor to QuickBooks Online?
- Connect the QuickBooks company in DeepLedger. In DeepLedger, open Companies, select the company, open its Connections tab and choose Connect to QuickBooks. Complete Intuit's sign-in.
- Add DeepLedger to mcp.json. Merge the DeepLedger entry into
~/.cursor/mcp.jsonfor all projects, or.cursor/mcp.jsonfor one project, keeping any servers already there. - Enable the server and sign in. Open Customize in Cursor's sidebar, enable DeepLedger and sign in with your DeepLedger account when prompted.
- Check the tools loaded. Confirm DeepLedger's tools appear under Available Tools.
- Ask which company you are in. In Agent chat, ask Cursor to use DeepLedger and tell you which company is active.
Using DeepLedger, which company am I in?
Cursor reads the company profile and names the company, currency and fiscal year start. DeepLedger supports OAuth discovery and dynamic client registration, so there is no client ID or token to paste. Inspect tool arguments and approval requests as they appear; Cursor's run mode and enterprise policy decide which calls ask first.
How do I use a DeepLedger API key in Cursor?
Use a key only when browser sign-in isn't possible. Any team member can create one.
- In DeepLedger, open Settings → API keys and choose Create key.
- Name it, pick an Expiration, and choose All my companies or One company.
- Copy the key. It starts with
dl_live_and is shown once. - Set
DEEPLEDGER_API_KEYin the environment Cursor starts from, and use this entry instead of the URL-only one:
{
"mcpServers": {
"deepledger": {
"url": "https://mcp.deepledger.ai/mcp",
"headers": {
"Authorization": "Bearer ${env:DEEPLEDGER_API_KEY}"
}
}
}
}
The key acts as the person who created it, with that person's access. A One company key works only in that company and can't switch. There is no read-only switch on a key. Never paste the key itself into mcp.json, especially a project file that may be committed.
Next step: verify one company and one report
Ask Cursor:
Using DeepLedger, list the companies I can access and identify the active company. Ask me which company to use, then switch to it and confirm its name. Do not create or change accounting records.
Then a bounded report:
Using DeepLedger for [confirmed company], retrieve the profit and loss for September 1 through September 30, 2026, on an accrual basis. Show the company name, dates, basis, currency, income, expenses and net income. Do not create or change accounting records.
In QuickBooks Online → Reports → Profit and Loss, run the same company, dates and basis, and compare income, expenses and net income. A "connected" status or an AI summary is not verification. Your active company is shared across your AI apps, so confirm it when you change sessions. See selecting the right QuickBooks company. Follow the P&L analysis and verification workflow for what to compare.
What can Cursor do in QuickBooks after connecting?
DeepLedger works when you ask: Cursor acts only when you tell it to. Ask it to read the company's AI Brain and skills before it records anything, so it applies rules such as "Home Depot purchases for jobs go to Job Materials".
- Purchases: bills, expenses, bill payments and vendor credits.
- Sales: estimates, invoices, customer payments, sales receipts and credits.
- Other transactions: deposits, transfers and journal entries.
- Reports: profit and loss, balance sheet, cash flow, aging, general ledger and trial balance, plus saved custom reports.
- Month-end close: close checks, proposed entries and statements in the Close Sheet, which a person signs off.
- Tasks: questions and handoffs between you and the AI in DeepLedger's Tasks.
Prompts to try after the report check:
Using DeepLedger for [company], record a [amount] software subscription paid to [vendor] on [date] from [bank account], categorized to [expense account]. Check for an existing transaction and show me the entry before saving.
Using DeepLedger for [company], get the profit and loss for [start date] through [end date] and the balance sheet as of [end date]. Summarize the main changes from the previous period.
Is it safe to let Cursor write to QuickBooks?
DeepLedger enforces these on the server:
- Every write must carry its company (
companyId). If it is missing or differs from the active company, DeepLedger refuses withCOMPANY_REQUIREDorCOMPANY_MISMATCHand nothing is written. - Voids and deletes need confirmation. A void keeps the record; a delete of a posted transaction is refused on or before the company's closing date.
- Duplicate and open-document checks on supported recording paths.
DeepLedger also instructs the AI to send uncertain work to Tasks for a person to decide. That is guidance the AI follows, not a server lock, so review what it proposes.
A prompt that says "do not change records" is not a read-only permission. Read each proposed write before you approve it. More in AI write access to QuickBooks, safely.
Troubleshooting
DeepLedger is missing. Validate the JSON and the file location, restart Cursor, and enable DeepLedger in Customize.
Authentication fails. Open Output → MCP Logs, check the URL and retry with the right DeepLedger account. With the API-key entry, check that DEEPLEDGER_API_KEY is set in the environment Cursor starts from and that the key hasn't expired or been revoked. Share error text without tokens.
The server is blocked. Ask your administrator to check the MCP allowlist and network policy for https://mcp.deepledger.ai/mcp.
The agent answers without tools. Confirm Available Tools lists DeepLedger, ask for DeepLedger by name, and require report data with company context.
A write fails with COMPANY_MISMATCH. Another app switched your active company. Nothing was written. Confirm the company and try again.
Reports fail after a successful switch. That company's QuickBooks connection needs an admin to reconnect it on its Connections tab in DeepLedger.
You want to stop using it. Disable DeepLedger in Customize and remove its entry from mcp.json. Disabling tools is not revoking access: revoke the grant or key in DeepLedger too.
Configuration last checked against Cursor's documentation in November 2026.
Documentation and configuration last verified November 2, 2026. This guide was checked against the linked vendor documentation and DeepLedger's server implementation. We did not complete a new OAuth grant or retrieve an account-level report in this client during this revision. The prompts are suggested checks, not claimed test results. Have the account owner complete sign-in and the demo-company report comparison above before using business data.
Frequently asked questions
How do I connect Cursor to QuickBooks Online?
Add DeepLedger's MCP server to Cursor's mcp.json with the URL https://mcp.deepledger.ai/mcp, enable it under Customize, and sign in with your DeepLedger account. Your QuickBooks Online company must be connected in DeepLedger first. Cursor then has DeepLedger's QuickBooks tools for every company you can access.
Do I need an API key for the QuickBooks MCP in Cursor?
No. Cursor signs in to DeepLedger with OAuth, which is the recommended route. Use a DeepLedger API key only where browser sign-in is not possible; any team member can create one under Settings, API keys, Create key, and Cursor reads it from an environment variable.
Can Cursor write to my QuickBooks books?
Yes, when you ask and approve the tool call. DeepLedger exposes write tools for bills, expenses, invoices, deposits and journal entries. Every write must carry its company in companyId or DeepLedger refuses it and nothing is written, and voids and deletes need confirmation.
Does the Cursor QuickBooks connection work for my whole team?
Each person connects Cursor with their own DeepLedger sign-in. An admin connects each QuickBooks company to DeepLedger once, and every teammate reaches the companies they are assigned to through their own Cursor setup. No passwords are shared.
How do I disconnect Cursor from QuickBooks?
Disable DeepLedger under Customize and remove its entry from mcp.json. To revoke access fully, revoke the grant or API key in DeepLedger, or have an admin disconnect the company on its Connections tab. None of these steps deletes accounting records.
Related guides
- QuickBooks MCP server guide
- Connect OpenAI Codex to QuickBooks Online
- Build a custom QuickBooks AI agent with an API key
- First real task: fix uncategorized transactions
Browse all AI platforms and integrations.