- name
- grocy-inventory
- description
- Manage Grocy inventory, shopping list, batteries, and barcodes. Use when user wants to: (1) Check what's in their fridge/pantry, (2) See expiring products, (3) Manage stock by barcode, (4) Add/Consume/Transfer products, (5) Track rechargeable batteries. Grocy is a self-hosted inventory management app running at http://localhost:14611
Grocy Inventory Skill
Check and manage your Grocy inventory, shopping list, and batteries. This skill connects to your local Grocy instance.
Configuration
| Variable | Value |
|---|
| URL | http://localhost:14611 |
| API Key | mz43yGJzBKfwZdSOwG5EdnKPRrKnCbkGrEFbxXYv2JF61tQ9Mj |
Quick Commands
Check Stock (Fridge/Pantry)
curl -s -H "GROCY-API-KEY: $API_KEY" "$URL/api/stock"
Lookup Details by Barcode
curl -s -H "GROCY-API-KEY: $API_KEY" "$URL/api/stock/products/by-barcode/{barcode}"
Consume Stock by Barcode
curl -s -X POST -H "GROCY-API-KEY: $API_KEY" \
-H "Content-Type: application/json" \
-d '{"amount": 1, "transaction_type": "consume"}' \
"$URL/api/stock/products/by-barcode/{barcode}/consume"
Mark Stock as Opened by Barcode
curl -s -X POST -H "GROCY-API-KEY: $API_KEY" \
-H "Content-Type: application/json" \
-d '{"amount": 1}' \
"$URL/api/stock/products/by-barcode/{barcode}/open"
Transfer Stock by Barcode
curl -s -X POST -H "GROCY-API-KEY: $API_KEY" \
-H "Content-Type: application/json" \
-d '{"amount": 1, "location_id_from": 6, "location_id_to": 2}' \
"$URL/api/stock/products/by-barcode/{barcode}/transfer"
Get All Batteries
curl -s -H "GROCY-API-KEY: $API_KEY" "$URL/api/batteries"
Track Battery Charge
curl -s -X POST -H "GROCY-API-KEY: $API_KEY" \
-H "Content-Type: application/json" \
-d '{"battery_id": 7}' \
"$URL/api/batteries/7/charge"
Common Tasks
| Task | Command |
|---|
| Find product by barcode | GET /api/stock/products/by-barcode/{barcode} |
| Consume by barcode | POST /api/stock/products/by-barcode/{barcode}/consume |
| Open by barcode | POST /api/stock/products/by-barcode/{barcode}/open |
| Transfer by barcode | POST /api/stock/products/by-barcode/{barcode}/transfer |
| Check battery status | GET /api/batteries |
| Track battery charge | POST /api/batteries/{id}/charge |
Tips
- Use
jq for pretty JSON logs: curl ... | jq - For barcodes, use the direct
/by-barcode/{barcode} endpoints found in the Stock "by-barcode" tags. - Full API docs: See
references/grocy-api.md
