bottle-details
Look up individual bottles from your cellar by wine name, barcode, location, bin, or size. Filter by cellar or consumed state, with support for barcode scanning from photos.
Instructions
Look up individual bottles from the Bottles table — the per-bottle view spanning both in-cellar and consumed bottles, with barcode, exact location/bin, and size. Filter by wine name, location, bin, size, or barcode; set state to 'cellar' (default 'all' includes consumed). If the user attaches a photo of a bottle or its barcode, read the barcode digits from the image and pass them as the barcode filter. Location and Bin are account-specific labels, not physical descriptions — if a location/bin filter finds nothing, use cellar-stats with group_by=location or group_by=bin to see the actual values in use. Returns up to max_results per page (default 25) — pass offset to page through more.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bin | No | Specific bin/position (e.g. 'Drawer 2', '1-3') | |
| size | No | Bottle format (e.g. '750ml', '1500ml') | |
| query | No | Wine name search term | |
| state | No | Which bottles: 'cellar', 'consumed', or 'all' (default) | |
| offset | No | Result offset for pagination (default 0) | |
| barcode | No | Bottle barcode — e.g. read from a photo | |
| location | No | Storage location (e.g. 'Wine Fridge') | |
| max_results | No | Maximum results (default 25) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | Yes | ||
| total | Yes | ||
| offset | Yes | ||
| bottles | Yes |