python-quickbooks

What it is and what it does

python-quickbooks is a Python 3 client library for the Intuit QuickBooks Online API, enabling programmatic access to accounting data. It wraps OAuth 2.0 authentication via the intuit-oauth dependency and provides object-oriented interfaces to query, filter, create, update, and delete QuickBooks entities (customers, invoices, payments, etc.) with support for batch operations and change-data capture to track modifications since a given timestamp.

Developers pass an AuthClient to a QuickBooks client object along with a refresh token and company ID, then use chainable query methods (all, filter, where, query, count) to retrieve entities or batch operations to perform multiple writes in a single API call. The description warns that user input must be sanitized before passing to queries, as the library does not sanitize input itself.

Use it for:

• Sync QuickBooks customer and invoice data into a Python application for reporting or analytics
• Automate bulk customer or payment creation and updates via batch operations in a single API request
• Monitor accounting data changes since a specific timestamp using change-data capture for incremental sync workflows
• Build a custom accounting dashboard or integration layer that queries QuickBooks entities with complex filters and ordering
• Attach documents or notes to QuickBooks records programmatically via the Attachable API

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

A Python library for querying, creating, updating, and batch-processing QuickBooks Online entities through the Intuit API, with support for filtering, ordering, and change-data capture.

Yes. The library is actively maintained, has low install friction, carries a permissive MIT license, and provides a mature Python interface to QuickBooks Online. Install it if you need to integrate QuickBooks data into a Python application. Be aware that you must handle OAuth credential setup separately and sanitize any user input before passing it to queries.

Install

python-quickbooks on PyPI

pip install python-quickbooks

uv add python-quickbooks

poetry add python-quickbooks

Installing python-quickbooks

Before you install

Low friction install with four runtime dependencies (intuit-oauth, requests_oauthlib, requests, python-dateutil). Actively maintained as of March 2026 with 469 repository stars. Last release was April 2025.

License in practice

MIT license (permissive) places no restrictions on use, modification, or distribution in proprietary or open-source projects.

Quickstart

pip install python-quickbooks

from quickbooks import QuickBooks
from quickbooks.objects.customer import Customer

# Requires AuthClient from intuit-oauth dependency
client = QuickBooks(
    auth_client=auth_client,
    refresh_token='REFRESH_TOKEN',
    company_id='COMPANY_ID'
)

customers = Customer.all(qb=client)

Requires valid Intuit OAuth 2.0 credentials (CLIENT_ID, CLIENT_SECRET, ACCESS_TOKEN, REFRESH_TOKEN, COMPANY_ID) obtained from Intuit developer portal. Intuit is deprecating support for minor versions 1–74 beginning August 1, 2025.

Verify before relying

• Whether the library handles automatic token refresh when access_token expires without explicit user intervention
• Performance characteristics when querying large result sets (max 1000 entities per response)
• Extent of SQL query syntax support and any limitations beyond standard Intuit QBO query operations
• Specific Python version requirements (classifiers list versions 3.5–3.12 but requires_python is unspecified)

Package facts

Evidence: python_quickbooks-0.9.12-py3-none-any.whl

Keywords: quickbooks, qbo, accounting

Tags

More WWW/HTTP packages