---
id: conductor-py
version: "1.91.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# conductor-py — The official Python library for the conductor API

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

## What it is and what it does

Conductor-py is the official Python client for the Conductor API, a real-time gateway to QuickBooks Desktop data. It replaces the older XML-based SOAP model with a modern JSON REST API and provides full type safety through Pydantic models and TypedDicts, enabling autocomplete and inline documentation in your editor.

The library handles authentication, request queuing, timeouts, retries, and pagination transparently. It supports both synchronous and asynchronous clients (powered by httpx, with optional aiohttp support), making it suitable for both simple scripts and high-concurrency applications. You can query, create, or update any QuickBooks Desktop object type and receive fully-typed responses, with auto-pagination for list operations and helper methods for serialization.

Use it for:

- Sync QuickBooks Desktop invoices, bills, or customers into a Python application in real-time without polling or batch jobs.
- Build a multi-company QuickBooks Desktop dashboard or reporting tool that queries live data across multiple company files.
- Automate QuickBooks Desktop data entry—create invoices, bills, or other transactions programmatically with type-safe validation.
- Integrate QuickBooks Desktop with an async Python service or background worker that needs concurrent, non-blocking API calls.
- Enable AI assistants or MCP clients to explore and interact with QuickBooks Desktop data via the Conductor MCP Server.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A typed Python client for the Conductor API that provides real-time access to QuickBooks Desktop data—fetch, create, or update any QuickBooks Desktop object type with full type safety and both sync and async support.

Yes. Conductor-py is actively maintained, has no known vulnerabilities, low install friction, and permissive licensing. It is the official client for a modern QuickBooks Desktop API and provides genuine value if you need real-time, typed access to QuickBooks data. Install it if you are building on the Conductor platform; avoid it if you do not have a Conductor API account or need to work with QuickBooks Online instead.

## Install

pip install conductor-py
uv add conductor-py
poetry add conductor-py

## Installing conductor-py

Before you install: Low friction install with a pure-Python wheel and six common runtime dependencies (anyio, distro, httpx, pydantic, sniffio, typing-extensions). The package is actively maintained with a recent release and no known vulnerabilities.

License in practice: Licensed under Apache-2.0 (permissive), which allows commercial use, modification, and distribution with minimal restrictions—suitable for most production and proprietary projects.

Quickstart:

pip install conductor-py

import os
from conductor import Conductor

conductor = Conductor(
    api_key=os.environ.get("CONDUCTOR_SECRET_KEY"),
)

page = conductor.qbd.invoices.list(
    conductor_end_user_id="YOUR_END_USER_ID",
)
print(page.data)

Requires Python 3.9 or later; requires a valid Conductor API key (CONDUCTOR_SECRET_KEY environment variable).

Verify before relying:

- Whether the Conductor API service itself is production-ready and has SLA guarantees.
- Cost or rate-limiting details for the Conductor API backend.
- Whether multi-company support requires additional configuration or licensing.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 80.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

quickbooks desktop api python, quickbooks real-time data access, typed quickbooks client, quickbooks invoice management, quickbooks async python sdk, quickbooks data sync, quickbooks enterprise integration, quickbooks-integration, async-support, api-client

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