How do I install the Grocy Inventory skill?

Run npx skillmds@latest add dvcrn/grocy-inventory in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Grocy Inventory safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: WARNING. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Grocy Inventory?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Grocy Inventory free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Grocy Inventory?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Grocy Inventory by dvcrn — Agent Skill

Name: Grocy Inventory
Rating: 4.2 (5 reviews)
Author: dvcrn

Grocy Inventory

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

dvcrn Updated Sep 8, 2026 32 repo stars

File contents

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

---name: grocy-inventorydescription: 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 SkillCheck 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)```bashcurl -s -H "GROCY-API-KEY: $API_KEY" "$URL/api/stock"```### Lookup Details by Barcode```bashcurl -s -H "GROCY-API-KEY: $API_KEY" "$URL/api/stock/products/by-barcode/{barcode}" ```### Consume Stock by Barcode```bashcurl -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```bashcurl -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```bashcurl -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```bashcurl -s -H "GROCY-API-KEY: $API_KEY" "$URL/api/batteries"```### Track Battery Charge```bashcurl -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`

Frequently asked questions