🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

Listonic

by @jeremymahieu

Access Listonic shopping lists: list lists/items, add/check/delete items, and manage lists.

Versionv1.0.1
Downloads1,296
Stars⭐ 1
TERMINAL
clawhub install listonic

πŸ“– About This Skill


name: listonic version: 1.0.0 description: "Access Listonic shopping lists: list lists/items, add/check/delete items, and manage lists." metadata: {"clawdbot":{"emoji":"πŸ›’","requires":{"bins":["python3"]}}}

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

1. lists to show available shopping lists 2. items to inspect current items 3. add-item "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 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"
    

    βš™οΈ Configuration

    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"
    }