Mcp Quickbooks

io.github.codespar由 GitHub 帳號 codespar 發布v0.2.2更新於 Nov 3, 2026

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

已驗證STDIO僅桌面金融資料與分析商業與電商

概覽

AI 產生的概覽

面向 QuickBooks Online 的 MCP 伺服器，讓助理管理客戶、發票、付款、帳單、品項與科目，並取得損益表。

可以做什麼
  • 建立、更新與查詢客戶、供應商與品項
  • 建立、更新、作廢、刪除、寄送與取得發票
  • 記錄並查詢客戶付款，建立銷售收據與報價單
  • 建立與列出帳單，列出會計科目表
  • 依日期區間產生損益表
  • 使用 QuickBooks 類 SQL 查詢語法檢索清單端點
適用情境
適合讓助理直接處理公司的 QuickBooks Online 帳務：草擬並寄送發票、登錄收款、管理客戶與供應商，或在對話中直接取得損益表。
執行需求
以 npm 套件形式在本機透過 stdio 執行（需要 Node.js）。需要 QB_ACCESS_TOKEN（OAuth2 持有者權杖，約一小時過期，須在伺服器外自行更新）與 QB_REALM_ID（公司 ID）。選用的 QB_ENV 可選擇 sandbox（預設）或 production，QB_MINOR_VERSION 預設為 70。需要連線至 Intuit API 的網路。
安裝前請注意
伺服器持有可存取公司帳務資料的 QuickBooks 存取權杖，權杖取得與更新由呼叫端負責。多個工具會寫入、寄送、作廢或刪除財務紀錄，包括寄送發票郵件給客戶，且 QB_ENV 可指向正式帳套。允許助理操作真實資料前請先評估。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Mcp Quickbooks，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

@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)

ToolPurpose
create_customerCreate a customer in QuickBooks Online.
update_customerUpdate a customer.
get_customerRetrieve a customer by QuickBooks entity id.
list_customersQuery customers using QBO's SQL-like query language.
create_invoiceCreate an invoice.
update_invoiceUpdate an invoice.
void_invoiceVoid an invoice.
delete_invoiceDelete an invoice.
get_invoiceRetrieve an invoice by QuickBooks entity id.
send_invoiceEmail an invoice to the customer.
create_paymentRecord a customer payment against one or more invoices.
get_paymentRetrieve a payment by QuickBooks entity id.
create_itemCreate a product or service item.
list_itemsQuery items using QBO's SQL-like query language.
create_billCreate a bill (AP / money owed to a vendor).
list_billsQuery bills using QBO's SQL-like query language.
create_vendorCreate a vendor (supplier).
list_vendorsQuery vendors using QBO's SQL-like query language.
create_estimateCreate an estimate (quote).
create_sales_receiptCreate a sales receipt (paid-on-the-spot sale — combines invoice + payment).
list_accountsQuery the chart of accounts using QBO's SQL-like query language.
get_profit_and_loss_reportRun a Profit and Loss report for a date range.

Install

bash
npm install @codespar/mcp-quickbooks

Environment

bash
QB_ACCESS_TOKEN="..."   # OAuth2 bearer (expires in 1hr — caller refreshes)QB_REALM_ID="..."       # company id, issued on authorizationQB_ENV="sandbox"        # or "production". Default: sandboxQB_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

bash
# stdio (default)npx @codespar/mcp-quickbooks
# HTTPMCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-quickbooks

Query language

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

sql
SELECT * FROM Customer WHERE Active = true MAXRESULTS 50SELECT * 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

來源：packages/erp/quickbooks/README.md，提交 d0a519a

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.2.2最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分