{"_id":"@codespar/mcp-quickbooks","_rev":"5-592b7c28c0501a679431105d9267a5a8","name":"@codespar/mcp-quickbooks","dist-tags":{"latest":"0.2.2"},"versions":{"0.1.0":{"name":"@codespar/mcp-quickbooks","version":"0.1.0","keywords":["mcp","quickbooks","qbo","intuit","erp","accounting","invoicing","oauth2"],"license":"MIT","_id":"@codespar/mcp-quickbooks@0.1.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-quickbooks":"dist/index.js"},"dist":{"shasum":"b5735ec83285b8c889d0e79ddaf1cdd92594e307","tarball":"https://registry.npmjs.org/@codespar/mcp-quickbooks/-/mcp-quickbooks-0.1.0.tgz","fileCount":6,"integrity":"sha512-nna/U0Lp7RAJeCBjHAokhlyKE3Wqf1NjT2L2hx+q6uC1/OPUdyrDnfPoxDBKBDhH9IEQbHopbDZo67MoItcXIg==","signatures":[{"sig":"MEYCIQDCjrHDN1EuLY2Vcax0ROcem1ypO06U+bD4v8neExUThgIhAP2NYUuMngvzv+VfzJjEE9TkfVSPNJ486cKY08Le/CPW","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":46456},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"8f8994b2acdc8be3a6c666b30ef44974f33752ed","mcpName":"io.github.codespar/mcp-quickbooks","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for QuickBooks Online (Intuit) — global ERP/accounting platform. Customers, invoices, payments, items, accounts, and P&L reports.","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-quickbooks_0.1.0_1776997175436_0.05869160046003463","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@codespar/mcp-quickbooks","version":"0.2.0","keywords":["mcp","quickbooks","qbo","intuit","erp","accounting","invoicing","oauth2"],"license":"MIT","_id":"@codespar/mcp-quickbooks@0.2.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-quickbooks":"dist/index.js"},"dist":{"shasum":"e3e5335cdf00b4252afc70fb8950e189aac6deb5","tarball":"https://registry.npmjs.org/@codespar/mcp-quickbooks/-/mcp-quickbooks-0.2.0.tgz","fileCount":6,"integrity":"sha512-y1h1K14eybcrHekgxn69eUBs8dcrBh6BovXOkTEgQKTbx4LxKQkcfsb8uegjDL5lZTg/WnnXUYU3iRQ986PLKA==","signatures":[{"sig":"MEUCIQDiTLPyU013Y/LNnF5vlbvxQ41PUEQoNEyIRFwi52j6SQIgayxT+qUpjbrhqhFEaAcCyPcKjchGTveyZzLBRaBlqys=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":78724},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"475d6a412c639d70728792f31d502e9268bb06bb","mcpName":"io.github.codespar/mcp-quickbooks","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for QuickBooks Online (Intuit) — global ERP/accounting platform. Customers, invoices, payments, items, accounts, and P&L reports.","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-quickbooks_0.2.0_1777042996152_0.2183182424071246","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@codespar/mcp-quickbooks","version":"0.2.1","keywords":["mcp","quickbooks","qbo","intuit","erp","accounting","invoicing","oauth2"],"license":"MIT","_id":"@codespar/mcp-quickbooks@0.2.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-quickbooks":"dist/index.js"},"dist":{"shasum":"b2f6c3f428e635d9c53973d6a649b97575d06129","tarball":"https://registry.npmjs.org/@codespar/mcp-quickbooks/-/mcp-quickbooks-0.2.1.tgz","fileCount":6,"integrity":"sha512-nh88OhwjQE3bDnRaqVAmtn68kfgQcnLiSHjGFlaLSHDXzHSZJz5OGBRujVO2VXiEuGnBMKxgNPIaLjhMHdDZgg==","signatures":[{"sig":"MEUCIG8X7SlVKJe9Ix7uHnqKYupwfJvEv5e1GqpWEQlymlsOAiEA1kzpdSCdMhupA+xEr1tTpTj13Myrs8pelL8c4NVYJ/w=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":79561},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"0ab801a863239f0cb986bbda65abbaee3c621b44","mcpName":"io.github.codespar/mcp-quickbooks","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for QuickBooks Online (Intuit) — global ERP/accounting platform. Customers, invoices, payments, items, accounts, and P&L reports.","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-quickbooks_0.2.1_1777123067931_0.8497778089352175","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@codespar/mcp-quickbooks","version":"0.2.2","description":"MCP server for QuickBooks Online (Intuit) — global ERP/accounting platform. Customers, invoices, payments, items, accounts, and P&L reports.","type":"module","main":"./dist/index.js","bin":{"mcp-quickbooks":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"@types/node":"^25.5.0","typescript":"^5.8.0"},"license":"MIT","keywords":["mcp","quickbooks","qbo","intuit","erp","accounting","invoicing","oauth2"],"mcpName":"io.github.codespar/mcp-quickbooks","_id":"@codespar/mcp-quickbooks@0.2.2","gitHead":"e8f2ad023876683538fe7b66a2fc88ab8d8ef92f","types":"./dist/index.d.ts","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-eeXrCUjgfKl7U+MW9BNZvNAGQ763fSjUcBNDh71W5/u8YbjyBXchUutxOSbg9wqo82piklcPct27IeJdBJlR7w==","shasum":"f4a490f09aa97db8f65c45473f77fc1b53426617","tarball":"https://registry.npmjs.org/@codespar/mcp-quickbooks/-/mcp-quickbooks-0.2.2.tgz","fileCount":6,"unpackedSize":81069,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDzSw5LdE79OTSasC5Mmh4YY0H9YuDepaZFETtl5AXTmAIgJb81uzOdZ5rO52JajPczI+jtsLgoPM/Wec/Lp3UB+hk="}]},"_npmUser":{"name":"codespar-npm","email":"fabiano@codespar.dev"},"directories":{},"maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-quickbooks_0.2.2_1782153610937_0.6498958926582421"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-24T02:19:35.379Z","modified":"2026-06-22T18:40:11.234Z","0.1.0":"2026-04-24T02:19:35.597Z","0.2.0":"2026-04-24T15:03:16.292Z","0.2.1":"2026-04-25T13:17:48.141Z","0.2.2":"2026-06-22T18:40:11.073Z"},"license":"MIT","keywords":["mcp","quickbooks","qbo","intuit","erp","accounting","invoicing","oauth2"],"description":"MCP server for QuickBooks Online (Intuit) — global ERP/accounting platform. Customers, invoices, payments, items, accounts, and P&L reports.","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"readme":"# @codespar/mcp-quickbooks\n\nMCP server for [QuickBooks Online](https://developer.intuit.com/app/developer/qbo/docs/api) (Intuit) — the most-used accounting platform in the US and UK, and the global default for small-business ERP.\n\nThis 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.\n\n## Tools (22)\n\n| Tool | Purpose |\n|---|---|\n| `create_customer` | Create a customer in QuickBooks Online. |\n| `update_customer` | Update a customer. |\n| `get_customer` | Retrieve a customer by QuickBooks entity id. |\n| `list_customers` | Query customers using QBO's SQL-like query language. |\n| `create_invoice` | Create an invoice. |\n| `update_invoice` | Update an invoice. |\n| `void_invoice` | Void an invoice. |\n| `delete_invoice` | Delete an invoice. |\n| `get_invoice` | Retrieve an invoice by QuickBooks entity id. |\n| `send_invoice` | Email an invoice to the customer. |\n| `create_payment` | Record a customer payment against one or more invoices. |\n| `get_payment` | Retrieve a payment by QuickBooks entity id. |\n| `create_item` | Create a product or service item. |\n| `list_items` | Query items using QBO's SQL-like query language. |\n| `create_bill` | Create a bill (AP / money owed to a vendor). |\n| `list_bills` | Query bills using QBO's SQL-like query language. |\n| `create_vendor` | Create a vendor (supplier). |\n| `list_vendors` | Query vendors using QBO's SQL-like query language. |\n| `create_estimate` | Create an estimate (quote). |\n| `create_sales_receipt` | Create a sales receipt (paid-on-the-spot sale — combines invoice + payment). |\n| `list_accounts` | Query the chart of accounts using QBO's SQL-like query language. |\n| `get_profit_and_loss_report` | Run a Profit and Loss report for a date range. |\n\n## Install\n\n```bash\nnpm install @codespar/mcp-quickbooks\n```\n\n## Environment\n\n```bash\nQB_ACCESS_TOKEN=\"...\"   # OAuth2 bearer (expires in 1hr — caller refreshes)\nQB_REALM_ID=\"...\"       # company id, issued on authorization\nQB_ENV=\"sandbox\"        # or \"production\". Default: sandbox\nQB_MINOR_VERSION=\"70\"   # optional, default 70\n```\n\n## Authentication\n\nQuickBooks 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).\n\n## Run\n\n```bash\n# stdio (default)\nnpx @codespar/mcp-quickbooks\n\n# HTTP\nMCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-quickbooks\n```\n\n## Query language\n\nQuickBooks list endpoints use a SQL-like syntax passed via `?query=`. Examples:\n\n```sql\nSELECT * FROM Customer WHERE Active = true MAXRESULTS 50\nSELECT * FROM Item WHERE Type = 'Service'\nSELECT * FROM Account WHERE AccountType = 'Income'\n```\n\nPass the full query string to `list_customers`, `list_items`, `list_accounts`.\n\n## Enterprise\n\nNeed governance, budget limits, and audit trails for agent payments? [CodeSpar Enterprise](https://codespar.dev/enterprise) adds policy engine, payment routing, and compliance templates on top of these MCP servers.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}