---
id: bring-api
version: "1.1.2"
license: MIT
license_treatment: permissive
maintenance: active
---

# bring-api — Unofficial package to access Bring! shopping lists API.

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

## What it is and what it does

bring-api is an async Python client for the unofficial Bring! shopping lists API. It lets you programmatically create and manage shopping lists, add items with specifications, check off purchases, and remove items—all via async/await calls backed by aiohttp. The package wraps the non-legacy Bring! API endpoint and supports both simple item operations (save, complete, remove) and batch operations that allow you to add multiple items at once, handle duplicate item names with different specs, and work with item UUIDs before persisting them to a list.

The library is designed for integration into automation workflows, home-assistant setups, and custom shopping-list applications. It requires Python 3.11+, depends on aiohttp for HTTP transport and mashumaro/orjson for serialization, and is actively maintained. No known vulnerabilities are recorded. The codebase is small and straightforward, making it suitable for both simple scripts and embedded use in larger systems.

Use it for:

- Automate grocery list management in a home-assistant integration or smart-home workflow.
- Build a custom shopping-list app or CLI that syncs with Bring! without using the official mobile app.
- Batch-add recipe ingredients to a Bring! list programmatically from a meal-planning tool.
- Check off items from a shopping list via voice command or IoT trigger in an automation system.
- Sync shopping lists across multiple household members or systems by polling and updating via the API.

## Worth the install?

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

Provides async Python access to the Bring! shopping lists API, allowing you to manage shopping lists, add/remove items, and check off purchases programmatically.

Yes. The package is actively maintained, has low install friction, carries no known vulnerabilities, and uses a permissive MIT license. It fills a genuine need for programmatic Bring! list management. Install it if you want to automate shopping-list workflows or integrate Bring! into a larger system; the async design and batch-update support make it suitable for both simple scripts and production integrations.

## Install

pip install bring-api
uv add bring-api
poetry add bring-api

## Installing bring-api

Before you install: Low install friction with a pure-Python wheel distribution. Actively maintained with recent commits and a small but stable dependency footprint (aiohttp, masjuni, orjson).

License in practice: MIT license permits commercial and private use with minimal restrictions—you may use, modify, and distribute this package freely provided you retain the license notice.

Quickstart:

pip install bring-api

import aiohttp
import asyncio
from bring_api import Bring

async def main():
    async with aiohttp.ClientSession() as session:
        bring = Bring(session, "email@example.com", "password")
        await bring.login()
        lists = (await bring.load_lists())["lists"]
        await bring.save_item(lists[0]['listUuid'], 'Milk')

asyncio.run(main())

Requires Python 3.11 or later and an active aiohttp event loop; cannot run multiple aiohttp sessions on the same thread.

Verify before relying:

- Whether the package works with Bring! account credentials or requires additional authentication setup beyond email/password.
- Rate limiting or throttling behavior when making rapid API calls to add/remove/complete items.
- Offline fallback or caching behavior if the Bring! API becomes temporarily unavailable.

## Package facts

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

## Tags

bring shopping list api, async shopping list management, bring app integration python, grocery list api client, shopping list automation, async-http, shopping-list, home-automation

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