listonic
Access Listonic shopping lists: list lists/items, add/check/delete items, and manage lists.
Setup & Installation
Install command
clawhub install jeremymahieu/listonicIf the CLI is not installed:
Install command
npx clawhub@latest install jeremymahieu/listonicOr install with OpenClaw CLI:
Install command
openclaw skills install jeremymahieu/listonicor paste the repo link into your assistant's chat
Install command
https://github.com/openclaw/skills/tree/main/skills/jeremymahieu/listonicWhat This Skill Does
Manages Listonic shopping lists through the unofficial web API. Supports listing, adding, checking, and deleting items, as well as creating and renaming lists. Uses token-based or email/password authentication.
Lets you manage shopping lists from the command line or via an agent without switching to the Listonic mobile or web app.
When to Use It
- 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
View original SKILL.md file
# 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)
```json
{
"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):
```json
{
"accessToken": "short-lived-access-token",
"clientId": "listonicv2",
"clientSecret": "fjdfsoj9874jdfhjkh34jkhffdfff",
"redirectUri": "https://listonicv2api.jestemkucharzem.pl"
}
```
### Fallback: email/password mode
```json
{
"email": "you@example.com",
"password": "your-listonic-password"
}
```
## Workflow
1. `lists` to show available shopping lists
2. `items <list>` to inspect current items
3. `add-item <list> "Name"` to add items
4. `check-item` / `uncheck-item` to toggle completion
5. `delete-item` only 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**.
- `list` arguments can be list ID or a list name (exact/partial match).
## Commands
### Show all lists
```bash
bash scripts/listonic.sh lists
```
### Show items in a list
```bash
bash scripts/listonic.sh items 12345
bash scripts/listonic.sh items "Groceries"
```
### Add item
```bash
bash scripts/listonic.sh add-item "Groceries" "Milk"
bash scripts/listonic.sh add-item "Groceries" "Flour" --amount 2 --unit kg
```
### Check / uncheck item
```bash
bash scripts/listonic.sh check-item "Groceries" 987654
bash scripts/listonic.sh uncheck-item "Groceries" 987654
```
### Delete item
```bash
bash scripts/listonic.sh delete-item "Groceries" 987654
```
### Create / rename / delete list
```bash
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
bash scripts/listonic.sh --json lists
bash scripts/listonic.sh --json items "Groceries"
```
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: Adding groceries to a shared shopping list while meal planning
- 1Adding groceries to a shared shopping list while meal planning
- 2Checking off items as you shop without opening the Listonic app
- 3Creating a separate list for a one-off event like a party
- 4Reviewing what's already on a list before heading to the store
- 5Removing completed or duplicate items from an existing list
Access Listonic shopping lists: list lists/items, add/check/delete items, and manage lists.
Security Audits
These signals reflect official OpenClaw status values. A Suspicious status means the skill should be used with extra caution.