Repository avatar
AI Tools
v1.0.10
active

mcp

ai.deepledger/mcp

Connect QuickBooks, Xero, Bill.com, Blackbaud and Stripe to ChatGPT, Claude, Grok and any AI app.

Documentation

DeepLedger

The accounting harness for AI

DeepLedger connects QuickBooks Online, QuickBooks Desktop (beta), Xero, Bill.com and Stripe (for reporting) to Claude, ChatGPT, Cursor, Grok and other AI agents through one MCP address. Record bills, invoices, payments, journal entries and other transactions, run reports, reconcile and close the month across every company you manage, with your firm's rules, review tasks and audit history built in.

This repository packages DeepLedger as a plugin for Claude Code, Cursor and Grok Build. Install it, sign in with your DeepLedger account, and ask for bookkeeping in plain language. The AI agent works the active company the way a staff accountant would: it looks up the payee, checks for duplicates, picks the right transaction type, records it, and hands anything it is not sure about to a human reviewer instead of guessing.

The ledger stays the record. DeepLedger holds the connections your company authorized (QuickBooks through Intuit's own OAuth flow, Xero through Xero's own sign-in, QuickBooks Desktop through the QuickBooks Web Connector on your own machine, Bill.com with your own BILL credentials, Stripe through Stripe's official MCP), so the plugin never sees those credentials. One sign-in reaches every company you can open in the DeepLedger portal.

What it connects

AppWhat the AI agent can do
QuickBooks OnlineRead and write: transactions, master data, reports, projects, custom fields, recurring templates, bank feed, attachments
QuickBooks Desktop (beta)QuickBooks Desktop Enterprise (US edition) company files, through the QuickBooks Web Connector on the client's Windows machine. Read and write: lists, transactions and reports; create or update list records (not employees), bills, vendor credits, purchase orders, item receipts, checks, card charges and credits, invoices, sales receipts, credit memos, estimates, sales orders, statement charges, received payments, bill payments, deposits, journal entries, inventory adjustments, builds and stock transfers, time and mileage, and custom fields; void or delete a transaction; delete, merge or inactivate a list record. The AI agent is instructed to run each write as a dry run and ask you to confirm before it is sent. Transactions, reports and every write need that machine on and connected
XeroRead and write: invoices, bills, credit notes, payments, spend and receive money, transfers, manual journals, quotes, repeating invoices, tracking categories, reports. New invoices, bills, credit notes and journals are saved as drafts by default
Bill.comRead bills, invoices, vendor credits, credit memos, payments, aging, vendors, customers and accounts; save drafts and edit vendors, customers, bills and open invoices. It never pays, approves or sends anything in BILL
Stripe (for reporting)Read only: balance, payouts, charges, refunds, disputes, invoices, customers and subscriptions. It never refunds, pays or changes anything in Stripe

A company's books are on QuickBooks Online, QuickBooks Desktop or Xero. Bill.com and Stripe connect next to the ledger, on the company's Connections tab in the DeepLedger portal.

Who it is for

  • Accounting firms and bookkeepers managing many client companies. One connection switches between companies on any ledger, every write follows the same checks, and uncertain items land in Tasks with the agent's reasoning attached (on QuickBooks Desktop companies the agent asks you instead, for now).
  • In-house finance teams running several companies or entities, who want the month-end close, reconciliation prep and management reports drafted for review.
  • Small business owners who keep their own books in QuickBooks Online, QuickBooks Desktop or Xero and want the routine entries, categorization and reports done for them.

What it does

AreaWhat the AI agent does
Bank feedPulls unrecorded bank and card transactions, categorizes them from the company's rules and history, records the clear ones and creates review tasks for the rest
RecordingRecords expenses, bills, invoices, payments, deposits, transfers, refunds, credits and journal entries with an ID lookup and a duplicate check before every write
Payables and receivablesEnters bills and pays them against outstanding balances in the ledger, invoices customers and applies their payments, applies credits, reports aging
ReconciliationMatches a bank or card statement to the ledger and prepares the reconciliation for your review
Month-end closeWorks the close checklist, proposes adjusting entries, and hands the close to a reviewer for sign-off
Reports and analysisRuns P&L, balance sheet, aging and saved reports, compares periods and explains what moved; builds dashboards across companies
Audit preparationBuilds supporting schedules, an evidence index and a missing-document list
AI BrainReads and maintains your firm's and each client's rules and policies; where they differ, the client's rule wins
Human reviewAnything uncertain becomes a task with the agent's reasoning; a reviewer signs off

How to use it

  1. Connect your companies at deepledger.ai: each company's QuickBooks Online, QuickBooks Desktop or Xero books, then Bill.com or Stripe on its Connections tab if you use them.

  2. Install the plugin in your host (below) and sign in when the browser opens.

  3. Ask in plain language. The bookkeeping skill activates on any accounting request:

    Which company is active?
    Switch to Harbour Cafe.
    Process last week's bank feed.
    Record: paid $500 to Office Depot for office supplies with the company credit card.
    Enter the Acme invoice for $2,400, net 30.
    Reconcile the operating account against the October statement.
    Compare the P&L for October against September.
    Close the books for October.
    
  4. Review what it escalated. Open Tasks in the DeepLedger portal to approve, correct or dismiss items the agent was not sure about. The agent records approved work when you next ask it to.

The plugin itself is thin: a connector to DeepLedger's hosted MCP server and one skill. The skill does not carry procedures; it tells the agent to read the company's own playbook from the server's skills tool for each kind of request, so bookkeeping guidance updates on the server, and per company, without a plugin release. There are no slash commands, agents, hooks or scripts.

Prerequisites

  • A DeepLedger account with at least one company connected at deepledger.ai, on QuickBooks Online, QuickBooks Desktop or Xero
  • One of the hosts below

Install

Marketplace availability depends on each marketplace's review. Until a listing appears, use the local install for that host. Setup guides for every AI app: deepledger.ai/integrations.

Claude Code

claude plugin marketplace add DeepLedger/deepledger-plugin
claude plugin install deepledger@deepledger-marketplace

Local development: claude --plugin-dir ./deepledger-plugin. Guide: Connect Claude Code.

Cursor

Clone this repository and symlink it into Cursor's local plugins folder, then reload Cursor.

git clone https://github.com/DeepLedger/deepledger-plugin.git
mkdir -p ~/.cursor/plugins/local
ln -s "$(pwd)/deepledger-plugin" ~/.cursor/plugins/local/deepledger

Guide: Connect Cursor.

Grok Build

DeepLedger is submitted to the xAI plugin marketplace as a remote source pinned to a commit of this repository. Once it is listed, open the extensions modal inside Grok Build with /plugins (or browse with /marketplace), select DeepLedger and install it. Grok Build reads the .grok-plugin/plugin.json manifest, the skill and .mcp.json directly. Enable and trust the plugin so Grok can connect to the bundled MCP server; the first DeepLedger tool call opens the browser sign-in, and /mcps shows the connection.

To install before the listing, pin a revision straight from GitHub:

grok plugin install DeepLedger/deepledger-plugin@<full-commit-sha> --trust

Local development: grok --plugin-dir ./deepledger-plugin.

Grok chat and Grok Bot

These do not use this plugin; they connect to the same MCP address directly. Steps for both: Connect Grok and Grok Bot.

  • Grok chat: open grok.com/connectors, choose New Connector, then Custom, paste https://mcp.deepledger.ai/mcp and sign in with your DeepLedger account.
  • Grok Bot: DeepLedger is not in the Grok Bot plugin catalog. In a Grok Bot chat, ask it to add DeepLedger as a custom MCP server at https://mcp.deepledger.ai/mcp, then complete the sign-in.

Sign-in

On first use the host discovers the server's OAuth 2.1 endpoints (authorization code with PKCE, dynamic client registration) and opens a browser sign-in. Sign in with your DeepLedger account and the connection is authorized. DeepLedger personal API keys (dl_live_...) are also accepted as Bearer tokens for programmatic clients. The transport is Streamable HTTP at https://mcp.deepledger.ai/mcp.

Network access and credentials

The plugin ships no scripts, binaries, hooks or shell commands. Everything it does goes through the hosted MCP server. The one runtime exception is the attachment upload below, where the server returns a shell-quoted curl command for the agent to run. The only network endpoints it reaches are:

EndpointPurpose
https://mcp.deepledger.ai/mcpMCP server (Streamable HTTP). All ledger and connected-app reads and writes, skills, tasks, AI Brain, documents and reports.
https://mcp.deepledger.ai/.well-known/oauth-authorization-server, /.well-known/oauth-protected-resource, /oauth/register, /oauth/authorize, /oauth/token, /oauth/revokeOAuth 2.1 discovery, dynamic client registration, authorization code with PKCE, token refresh and revocation.
https://deepledger.aiBrowser sign-in page opened by the host during authorization.
https://mcp.deepledger.ai/upload-to-qbQuickBooks file attachment. documents (operation upload) returns a curl command the agent runs to send one user-chosen local file (10 MB limit) to this path with a one-time token; the server forwards it to QuickBooks. It downloads and executes nothing.
https://xero.deepledger.ai/upload-to-xeroThe same attachment upload for a Xero company (10 MB limit).

Credentials: a DeepLedger account (OAuth sign-in in the browser; the host asks for the scopes the server advertises). The host stores the resulting token; the plugin never sees, stores or transmits QuickBooks, Xero, BILL or Stripe credentials, and it reads no local files, environment variables or secrets. Access is scoped to the companies the signed-in user can already open in the DeepLedger portal, at that user's access level (read only, or read and write).

How the skill works

The bookkeeping skill activates on any accounting request. It confirms the active company with companies, then reads the matching skill with skills and follows its steps and safety rules:

RequestSkill (default name)
Record a payment, bill, invoice, refund, credit, deposit, transfer or journal entry; categorize bank feed items; payables and receivables writesrecord-transactions
Close a month, adjusting entriesmonth-end-close
Reconcile a statement, explain a reconciliation differencereconcile-bank
Audit or review support, evidence index, missing documentsaudit-preparation
First-time setup of a companyget-started
A tool failure the agent cannot resolve from the responseskills operation errors (per tool and error code)

Each company starts from DeepLedger's default skills and can keep its own preferences. Master data, the AI Brain, review tasks, documents and saved reports follow their tool descriptions; any write to the books still goes through the recording skill.

What the connector provides

The .mcp.json connector points at DeepLedger's official hosted MCP server. It installs no local binary. Signed-in users get the DeepLedger tools (a user whose companies are all on QuickBooks Desktop gets a shorter set: companies, connections, describeTool, callReadTool, callWriteTool and tasks); each app's own tools are listed for users whose companies have that app connected. Every tool that touches the books operates on the active company and names it in its result.

DeepLedger (every user)

ToolCapability
companiesShow, list or switch the active company on any ledger; send feedback to DeepLedger
connectionsWhich apps each company has connected, which need a reconnect, and each app's tools
dashboardRead-only dashboard numbers across companies: firm summary, company overview, close board
describeToolFull description and input schema of any connected app's tool
callReadToolRun a read with any connected app's tool, including tools not in your list yet
callWriteToolRun a write with any connected app's tool, with the same checks as calling it directly
tasksReview tasks shared between the agent and the human reviewer
agentMemoryRead and maintain the company's AI Brain: procedures, policies and vendor and customer rules
documentsRead documents from DeepLedger storage or ledger attachments, and upload a file to a ledger record
closeRunTrack the month-end close
closeTemplatePropose the company's close checklist, approved in the portal
reconciliationPrepare a bank or card reconciliation, finished in the ledger
customReportsRun saved report definitions by name
skillsThe company's own playbook for each job, and error recovery per tool
getGuideEarlier name for skill reads, kept for compatibility

QuickBooks Online

ToolCapability
qbCompanyProfileShow, list or switch the active QuickBooks company
qbMasterDataLook up, create or update accounts, vendors, customers, items, classes and tax codes
qbFetchTransactionsFetch transactions for duplicate checks, payee history and outstanding bills or invoices
qbExpenseRecord or update a purchase paid now (card, ACH, check, cash)
qbBillRecord or update a vendor bill to pay later
qbPaymentApply a customer payment to outstanding invoices, or pay outstanding bills applying vendor credits
qbInvoiceCreate or update a customer invoice
qbSalesReceiptRecord a sale paid on the spot, or refund a customer
qbDepositRecord a bank deposit, batching held payments or direct income lines
qbTransferMove money between the company's own accounts in the ledger
qbCreditRecord a vendor or customer credit
qbJournalEntryRecord a balanced journal entry
qbEstimateCreate, update or convert an estimate
qbRecurringTransactionManage recurring transaction templates
qbProjectList, create, update and close QuickBooks projects
qbCustomizationManage custom field definitions and transaction dimensions
qbVoidTransactionVoid or delete a transaction, after confirmation
qbSendEmailEmail a sales document to the customer through QuickBooks
qbReportsRun profit and loss, balance sheet, aging and other QuickBooks reports
bankFeedFetch unrecorded bank transactions and mark them once recorded

QuickBooks Desktop (beta)

Listed for users whose companies are all on QuickBooks Desktop; next to QuickBooks Online or Xero companies, reach them through describeTool and callReadTool / callWriteTool. The AI agent is instructed to run each write as a dry run (dryRun) and ask you to confirm before it is sent.

ToolCapability
qbdesktopCompanyThe connected company file: name, fiscal year, features switched on
qbdesktopMasterDataLook up every list (accounts, customers and jobs, vendors, items, classes and the reference lists); create or update list records (not employees)
qbdesktopFetchTransactionsRead every kind of transaction live from QuickBooks
qbdesktopReportsProfit and loss, balance sheet, trial balance, general ledger, aging and other QuickBooks Desktop reports
qbdesktopSyncHow current the copy of the lists is; refresh it
qbdesktopPurchasesBills, vendor credits, purchase orders, item receipts, checks and card charges
qbdesktopSalesInvoices, sales receipts, credit memos, estimates, sales orders and statement charges
qbdesktopPaymentsReceived payments, bill payments and deposits (records that money moved; moves none)
qbdesktopJournalEntryGeneral journal entries; debits must equal credits
qbdesktopInventoryAdjust stock, build assemblies, transfer stock between sites
qbdesktopTimeTime entries and mileage
qbdesktopCustomizationCustom field values and definitions
qbdesktopVoidOrDeleteVoid or delete a transaction; delete, merge or inactivate a list record

Xero

ToolCapability
xeroOrganisationThe active Xero organisation's details
xeroMasterDataLook up accounts, contacts, items, tax rates, tracking categories and currencies; create or update accounts, contacts and items
xeroFetchTransactionsSearch transactions for duplicate checks, history and outstanding documents
xeroInvoiceSales invoices
xeroBillBills
xeroCreditNoteCredit notes
xeroPaymentPayments against invoices, bills and credit notes
xeroBankTransactionSpend and receive money
xeroBankTransferTransfers between the organisation's bank accounts
xeroManualJournalManual journals
xeroQuoteQuotes
xeroRepeatingInvoiceRepeating invoices
xeroTrackingCategoryTracking categories
xeroReportsProfit and loss, balance sheet, aging and other Xero reports
xeroBankingRead-only bank view: bank accounts, balances and unreconciled ledger items

Bill.com (your own BILL credentials; never pays, approves or sends)

ToolCapability
billcomMasterDataRead vendors, customers, accounts and classifications; create, update or archive vendors and customers
billcomFetchTransactionsRead bills, vendor credits, payments made and received, invoices, credit memos and AP and AR aging
billcomBillSave bills unapproved and unpaid, edit their dates, numbers and descriptions, and record vendor credits
billcomInvoiceSave invoices without sending them, update them, and record credit memos

Stripe (for reporting, read only)

ToolCapability
stripemcpReadRead the connected Stripe account through Stripe's official MCP: balance, payouts, charges, refunds, disputes, invoices, customers and subscriptions

Safety model

Every write to the books follows the server's checks, carried by the recording skill and the tool descriptions:

  1. Lookup: the ledger's master-data tool resolves vendor, customer and account IDs.
  2. Duplicate check: the ledger's fetch tool verifies no duplicate exists.
  3. Decide: the agent records when the payee, category, tool and amount are clear from the evidence and it is confident; it creates a review task with specific reasoning when something is uncertain. Reviewer decisions on tasks are applied as decided.

Correctness guards do not yield to confidence: an outstanding bill or invoice dictates the tool, journal entries must balance, and voids and deletes need a fetch, a check and the user's confirmation first. Each write must name the company it is meant for, so a company switch in another chat cannot send a write to the wrong books. Every tool call is recorded in the company's Audit history. Read-only users cannot change the books.

DeepLedger has no tool that sends a payment or moves money from a bank account: in Bill.com it reads, drafts and edits, and never pays, approves or sends; Stripe is read only.

Architecture

Plugin (this repo)
  skills/bookkeeping/SKILL.md  One skill: confirm the company, read the matching company skill, verify
  .grok-plugin/plugin.json     Grok Build manifest
  .claude-plugin/plugin.json   Claude Code manifest
  .claude-plugin/marketplace.json  Claude Code marketplace entry
  .mcp.json                    MCP connector for Claude Code and Grok Build
  .cursor-plugin/plugin.json   Cursor manifest
  mcp.json                     MCP connector for Cursor
    | Streamable HTTP + OAuth 2.1
MCP server (hosted at https://mcp.deepledger.ai/mcp)
  DeepLedger tools for every user, plus the tools of each connected app:
  QuickBooks Online, QuickBooks Desktop (beta), Xero, Bill.com, Stripe (for reporting)

Data handling and support

Version and license

See CHANGELOG.md for release history. MIT License, see LICENSE.

No installation packages available.

Remote