---
id: python-quickbooks
version: "0.9.12"
license: MIT
license_treatment: permissive
maintenance: active
---

# python-quickbooks — A Python library for accessing the QuickBooks API.

License: permissive · Maintenance: active · Downloads: 975.2K/mo

## 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 above — 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

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

- License: MIT (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 975.2K/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

quickbooks api python client, intuit qbo accounting integration, quickbooks online sdk, batch operations quickbooks, quickbooks customer invoice management, qbo data sync python, quickbooks oauth authentication, accounting-integration, oauth-client, batch-operations

[View on SkillFed](https://skillfed.io/packages/python-quickbooks) · [View on PyPI](https://pypi.org/project/python-quickbooks/)