MoneyWiz-API

A Python API to access MoneyWiz Sqlite database.

Get Started

pip install moneywiz-api

from moneywiz_api import MoneywizApi

moneywizApi = MoneywizApi("<path_to_your_sqlite_file>")

(
    accessor,
    account_manager,
    payee_manager,
    category_manager,
    transaction_manager,
    investment_holding_manager,
) = (
    moneywizApi.accessor,
    moneywizApi.account_manager,
    moneywizApi.payee_manager,
    moneywizApi.category_manager,
    moneywizApi.transaction_manager,
    moneywizApi.investment_holding_manager,
)

record = accessor.get_record(record_id)
print(record)

It also offers a interactive shell moneywiz-cli.

Tests

Run unit tests without a database:

uv run pytest tests/unit

Integration tests are opt-in and never read a CLI default database path. Point MONEYWIZ_TEST_DB_PATH at a disposable MoneyWiz SQLite test database:

MONEYWIZ_TEST_DB_PATH=/absolute/path/to/test.sqlite uv run pytest tests

Contribution

This project is in very early stage, all contributions are welcomed!