Skip to main content

A simple Python SDK around the Lunch Money Developer API

Project description


PyPI PyPI - Python Version Docker Image Version GitHub License Testing Status Hatch project Ruff pre-commit semantic-release Gitmoji

lunchable is a Python Client for the Lunch Money Developer API. It's built on top of pydantic and httpx, it offers an intuitive API, a simple CLI, complete coverage of all endpoints, and a plugin framework for extending the functionality of the library.


pip install lunchable


from typing import Any, Dict, List

from lunchable import LunchMoney
from lunchable.models import TransactionObject

lunch = LunchMoney(access_token="xxxxxxxxxxx")
transactions: List[TransactionObject] = lunch.get_transactions()

first_transaction: TransactionObject = transactions[0]
transaction_as_dict: Dict[str, Any] = first_transaction.model_dump()


To use the CLI, you'll need to set the LUNCHMONEY_ACCESS_TOKEN environment variable. It's recommended to use pipx to install the CLI - use the lunchable[plugins] extra to include all the known plugins:

pipx install "lunchable[plugins]"
export LUNCHMONEY_ACCESS_TOKEN="xxxxxxxxxxx"
lunchable transactions get --limit 5
lunchable http -X GET v1/assets

Check out the Docs

Looking to contribute? See the Contributing Guide

See the Changelog

juftin logo

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

lunchable-1.3.2.tar.gz (282.2 kB view hashes)

Uploaded Source

Built Distribution

lunchable-1.3.2-py3-none-any.whl (42.1 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page