QuickBooks Desktop

io.github.devwithmjPublished by GitHub account devwithmjv0.1.6Updated Nov 1, 2026

Read QuickBooks Desktop data and, if enabled, make safe changes. Windows only.

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

Local Windows MCP server that lets an assistant read QuickBooks Desktop company data and, if enabled, make guarded changes.

What you can do
  • Read customers, vendors, employees, items, accounts, invoices, bills, payments, inventory, time and custom fields as compact tables
  • Run standard reports such as aging, profit and loss, and balance sheet
  • Create, update, delete and void records when writes are enabled, with previews, confirmation tokens, idempotency keys, batches and an audit log
  • Open a record in the QuickBooks window and use Desktop-only data such as inventory assemblies, price levels and custom fields
  • Optionally serve MCP over local HTTP with an access key for clients that cannot start the server themselves
When to use it
For a business running QuickBooks Desktop Pro, Premier or Enterprise on Windows that wants an assistant to answer questions about its books, pull reports, or make controlled edits to records. Not suitable for QuickBooks Online or QuickBooks for Mac.
Requirements
Windows with a licensed QuickBooks Desktop installation, plus admin access to the company file for a one-time authorization inside QuickBooks. Runs locally via npx, dnx, an .mcpb bundle or an exe. Optionally set QB_COMPANY_FILE to the .qbw path, or leave it empty to use the file open in QuickBooks. No developer account or OAuth needed.
Before you install
Read-only by default; writes require opting in with a flag or environment variables such as QB_ALLOW_WRITES, and deletes and voids always need confirmation. Sensitive numbers are masked and payroll is off by default, but enabling writes lets the assistant create, change, delete or void real accounting records. The HTTP mode needs an access key (QB_HTTP_KEY) and should not be exposed without your own tunnel. Pre-1.0 and tested only against one Enterprise edition and year.

Installation

In SourceWeft

  1. Open QuickBooks Desktop in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

quickbooks-mcp

Open-source MCP server that connects QuickBooks Desktop (Pro, Premier, Enterprise) to LLMs and agents.

[npm] [NuGet] [Release] [License: MIT]

Status: pre-1.0. Run so far against QuickBooks Desktop Enterprise Accountant 24.0 with Intuit's sample company file; other editions and years are not yet tested (see COMPATIBILITY.md, and the tester guide if you can help).

What you get

  • Read: customers, vendors, employees, items, accounts, invoices, bills, payments, inventory, time, custom fields, and every standard report (aging, P&L, balance sheet, ...), as compact tables.
  • Change, only if you allow it: create, update, delete and void, with previews, confirmation tokens, idempotency keys, batches and an audit log.
  • Safe by default: read-only, tax IDs and bank and card numbers masked, payroll off, card data never accepted.
  • Local: runs on your Windows PC next to QuickBooks and talks to it through its SDK. No cloud, no telemetry.

Install

Claude Desktopopen the .mcpb from the latest release
Claude Code/plugin marketplace add devwithmj/quickbooks-mcp, then /plugin install quickbooks-desktop@quickbooks-mcp
npxnpx -y @devwithmj/quickbooks-mcp
dnxdnx DevWithMJ.QuickBooks.Mcp --yes
exequickbooks-mcp-win-x64.exe (or -win-x86) from the release

Then allow access once in QuickBooks (--authorize) and add the server to your AI app. Step by step: docs/GUIDE.md.

Packages and listings: npm, NuGet, GitHub releases, the official MCP Registry (io.github.devwithmj/quickbooks-mcp) and Glama.

Turn on changes

Everything is read-only until you opt in. Add the flag to the arguments your MCP client starts the server with:

json
"args": ["-y", "@devwithmj/quickbooks-mcp", "--allow-writes"]

or set an environment variable: QB_ALLOW_WRITES=true for everything, or QB_ENABLE_WRITE, QB_ENABLE_UPDATE and QB_ENABLE_DELETE for one kind each (QB_WRITE_ALLOW=Invoice,Customer limits which record types can change). Deletes and voids always need a confirmation step. Details: docs/WRITES.md.

Use it over HTTP (advanced)

Most clients start the server themselves. For a client that cannot, quickbooks-mcp --http serves MCP over HTTP on 127.0.0.1:8765 only, and every request needs an access key (printed at start, or set QB_HTTP_KEY). Changes stay off unless you also pass --http-allow-writes. To reach it from another device, put your own tunnel in front of it: docs/REMOTE-ACCESS.md.

QuickBooks Online or Desktop?

This project is for QuickBooks Desktop. If you use QuickBooks Online, use Intuit's own server: intuit/quickbooks-online-mcp-server (Apache-2.0). We read its design for ideas and wrote our own code; no code was copied.

QuickBooks Online server (Intuit)This project (Desktop)
TargetsQuickBooks OnlineQuickBooks Desktop Pro, Premier, Enterprise (Windows)
Where it runsTalks to Intuit's cloud APIOn your PC, next to QuickBooks, through its local SDK
Setup and sign-inAn Intuit developer app and OAuthA one-time "allow this app" approval inside QuickBooks (--authorize); no developer account
Only on DesktopInventory assemblies and sites, price levels, workers comp codes, custom fields via data extensions, opening a record in the QuickBooks window
Only on OnlineAttachments, invoice PDFs and other cloud features
Safety defaultSee that projectRead-only until you enable writes; deletes and voids need your approval; sensitive numbers masked; payroll off; audit log
Data pathThrough Intuit's cloudStays on your computer except what the assistant is shown

The two do not share a company file or an account: a business on Online should not use this project, and a Desktop business cannot use Intuit's.

Requirements

  • Windows with QuickBooks Desktop installed and licensed.
  • Admin access to the company file for the one-time authorization.

Not for QuickBooks Online (Intuit has its own MCP server), QuickBooks for Mac (no SDK), card processing, or running as a Windows service. See docs/SCOPE.md.

Documentation

Legal

Not affiliated with or endorsed by Intuit. See NOTICE.md.

License

MIT

Source: README.md at commit f14f116

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

2
  1. v0.1.6LatestOct 18, 2026
  2. v0.1.4Oct 18, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts