OpenClaw · Skill
Listonic
Manage Listonic shopping lists via the unofficial web API.
Install
Start with the primary install command. Alternate entrypoints are included below for ClawHub and OpenClaw CLI users.
Primary command
clawhub install jeremymahieu/listonicClawHub installer
npx clawhub@latest install jeremymahieu/listonicOpenClaw CLI
openclaw skills install jeremymahieu/listonicDirect OpenClaw install
openclaw install jeremymahieu/listonicWhat this skill does
Manage Listonic shopping lists via the unofficial web API.
Why it matters
Lets you manage shopping lists from the command line or via an agent without switching to the Listonic mobile or web app.
Typical use cases
- Adding groceries to a shared shopping list while meal planning
- Checking off items as you shop without opening the Listonic app
- Creating a separate list for a one-off event like a party
- Reviewing what's already on a list before heading to the store
- Removing completed or duplicate items from an existing list
Source instructions
Listonic
Manage Listonic shopping lists via the unofficial web API.
Setup
Create ~/.openclaw/credentials/listonic/config.json using one auth mode.
Recommended: token mode (works with Google sign-in)
{
"refreshToken": "your-refresh-token"
}
Tip: the script now auto-refreshes access tokens and persists updated tokens back to config.
It also accepts refresh_token / access_token keys if you paste raw OAuth payload JSON.
Optional (advanced):
{
"accessToken": "short-lived-access-token",
"clientId": "listonicv2",
"clientSecret": "fjdfsoj9874jdfhjkh34jkhffdfff",
"redirectUri": "https://listonicv2api.jestemkucharzem.pl"
}
Fallback: email/password mode
{
"email": "you@example.com",
"password": "your-listonic-password"
}
Workflow
liststo show available shopping listsitems <list>to inspect current itemsadd-item <list> "Name"to add itemscheck-item/uncheck-itemto toggle completiondelete-itemonly when user explicitly wants removal
Important
- This uses an unofficial reverse-engineered API and may break if Listonic changes it.
- For destructive operations (
delete-item,delete-list), confirm with the user first. listarguments can be list ID or a list name (exact/partial match).
Commands
Show all lists
bash scripts/listonic.sh lists
Show items in a list
bash scripts/listonic.sh items 12345
bash scripts/listonic.sh items "Groceries"
Add item
bash scripts/listonic.sh add-item "Groceries" "Milk"
bash scripts/listonic.sh add-item "Groceries" "Flour" --amount 2 --unit kg
Check / uncheck item
bash scripts/listonic.sh check-item "Groceries" 987654
bash scripts/listonic.sh uncheck-item "Groceries" 987654
Delete item
bash scripts/listonic.sh delete-item "Groceries" 987654
Create / rename / delete list
bash scripts/listonic.sh add-list "BBQ Party"
bash scripts/listonic.sh rename-list "BBQ Party" "BBQ"
bash scripts/listonic.sh delete-list "BBQ"
Raw JSON output
bash scripts/listonic.sh --json lists
bash scripts/listonic.sh --json items "Groceries"