ClaudeCodeMod
SubmitAdvertise

All shelves / MCP servers

io.github.codespar/mcp-quickbooks

io.github.codespar/mcp-quickbooks · 273 stars · TypeScript · MIT

MCP server MCP server for QuickBooks Online (Intuit) — customers, invoices, payments, items, accounts, P&L

Install

The repo has no one-line install. Follow its README.

Published as

  • npm@codespar/mcp-quickbooksstdio

From the server's entry in the official MCP Registry.

Open the repo

Configuration

NameSet asWhat it is
QB_ACCESS_TOKENRequired · SecretEnv varQuickBooks OAuth2 bearer access token. Expires in 1hr — caller is responsible for refresh via Intuit's OAuth2 auth_code flow.
QB_REALM_IDRequiredEnv varQuickBooks company id (realmId). Issued when a user authorizes your app against a specific company.
QB_ENVOptionalEnv varQuickBooks environment: 'sandbox' (default) or 'production'. Selects sandbox-quickbooks.api.intuit.com vs quickbooks.api.intuit.com.
QB_MINOR_VERSIONOptionalEnv varQuickBooks API minor version. Defaults to 70.

Files

packages/erp/quickbooks/README.md

@codespar/mcp-quickbooks

MCP server for QuickBooks Online (Intuit) — the most-used accounting platform in the US and UK, and the global default for small-business ERP.

This is our global accounting anchor. While the catalog covers BR/LatAm ERPs (Omie, Conta Azul, Alegra, Bling, Tiny), LatAm SaaS companies that invoice international customers — or subsidiaries of US parent companies — almost universally keep their books in QuickBooks.

Tools (22)

Tool Purpose
create_customer Create a customer in QuickBooks Online.
update_customer Update a customer.
get_customer Retrieve a customer by QuickBooks entity id.
list_customers Query customers using QBO's SQL-like query language.
create_invoice Create an invoice.
update_invoice Update an invoice.
void_invoice Void an invoice.
delete_invoice Delete an invoice.
get_invoice Retrieve an invoice by QuickBooks entity id.
send_invoice Email an invoice to the customer.
create_payment Record a customer payment against one or more invoices.
get_payment Retrieve a payment by QuickBooks entity id.
create_item Create a product or service item.
list_items Query items using QBO's SQL-like query language.
create_bill Create a bill (AP / money owed to a vendor).
list_bills Query bills using QBO's SQL-like query language.
create_vendor Create a vendor (supplier).
list_vendors Query vendors using QBO's SQL-like query language.
create_estimate Create an estimate (quote).
create_sales_receipt Create a sales receipt (paid-on-the-spot sale — combines invoice + payment).
list_accounts Query the chart of accounts using QBO's SQL-like query language.
get_profit_and_loss_report Run a Profit and Loss report for a date range.

Install

npm install @codespar/mcp-quickbooks

Environment

QB_ACCESS_TOKEN="..."   # OAuth2 bearer (expires in 1hr — caller refreshes)
QB_REALM_ID="..."       # company id, issued on authorization
QB_ENV="sandbox"        # or "production". Default: sandbox
QB_MINOR_VERSION="70"   # optional, default 70

Authentication

QuickBooks uses OAuth2 authorization_code flow. Access tokens live 1hr; refresh tokens 100 days. This server assumes a valid QB_ACCESS_TOKEN is already issued — token acquisition and refresh live outside the MCP scaffold (typically in your agent's credential manager).

Run

# stdio (default)
npx @codespar/mcp-quickbooks

# HTTP
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-quickbooks

Query language

QuickBooks list endpoints use a SQL-like syntax passed via ?query=. Examples:

SELECT * FROM Customer WHERE Active = true MAXRESULTS 50
SELECT * FROM Item WHERE Type = 'Service'
SELECT * FROM Account WHERE AccountType = 'Income'

Pass the full query string to list_customers, list_items, list_accounts.

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT

Facts

Kind
MCP server
Repo
codespar/mcp-dev-latam
Group
Uncategorized
Stars
273
License
MIT
Language
TypeScript
Last push
2026-09-27
Forks
50
MCP Registry
io.github.codespar/mcp-quickbooks
Homepage
codespar.dev/servers
Topics
agentic-commerce, ai-agents, brazil, claude, fintech, latin-america, llm-tools, mcp, model-context-protocol, nfe, open-finance, payments, pix

More on this shelf

  1. 1REAio.github.morluto/reaReverse engineer anything from your terminal or agent with one CLI and MCP server.125.3k
  2. 2com.browser-use/browser-usecom.browser-use/browser-useControl a real Chrome browser to complete any task: fill forms, extract data, book flights.117.7k
  3. 3World Monitorapp.worldmonitor/mcpLive markets, conflicts, country risk, chokepoints, energy, and China decision signals. 93 tools.88.3k
  4. 4Scrapling MCP Serverd4vinci/scrapling🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scraplingdev86.9k
  5. 5Everythingmodelcontextprotocol/serversThis MCP server attempts to exercise all the features of the MCP protocol. It is not intended to be a useful server, but rather a test server for builders of MCP clients. It implements prompts, tools, resources, sampling, and more to showcase MCP capabilities.85.8k
  6. 6Fetchmodelcontextprotocol/serversA Model Context Protocol server that provides web content fetching capabilities. This server enables LLMs to retrieve and process content from web pages, converting HTML to markdown for easier consumption.85.8k