cozi
Productivity & Tasks
v1.0.2
BenignInteract with Cozi Family Organizer (shopping lists, todo lists, item management)
2468 downloads468 installsby @angusthefuzz
Setup & Installation
Install command
clawhub install angusthefuzz/coziIf the CLI is not installed:
Install command
npx clawhub@latest install angusthefuzz/coziOr install with OpenClaw CLI:
Install command
openclaw skills install angusthefuzz/cozior paste the repo link into your assistant's chat
Install command
https://github.com/openclaw/skills/tree/main/skills/angusthefuzz/coziWhat This Skill Does
Unofficial API client for Cozi Family Organizer. Manages shopping lists, todo lists, and calendar appointments via command-line. Uses a reverse-engineered API that may break if Cozi updates their service.
Lets an agent read and update Cozi lists and calendar without any manual app interaction.
When to Use It
- Adding groceries to a shared family shopping list
- Creating a chore list for the weekend
- Checking upcoming appointments on the family calendar
- Marking purchased items as done during a store run
- Scheduling an appointment with a location and time
View original SKILL.md file
# Cozi Skill
Unofficial client for Cozi Family Organizer API. Manage shopping lists and todo lists.
⚠️ **Important:** This uses an unofficial API (reverse-engineered). Cozi may change it at any time.
## Environment Variables
Set these in your agent's `.env` (`~/.openclaw/.env`) or create a skill-level `.env` at `~/.openclaw/skills/cozi/.env`:
- `COZI_EMAIL` — Your Cozi account email
- `COZI_PASSWORD` — Your Cozi account password
The script only reads `COZI_EMAIL` and `COZI_PASSWORD` from `.env` files — other variables are ignored.
## Commands
```bash
# Lists
node ~/.openclaw/skills/cozi/scripts/cozi.js lists # Show all lists
node ~/.openclaw/skills/cozi/scripts/cozi.js list <listId> # Show specific list
node ~/.openclaw/skills/cozi/scripts/cozi.js add <listId> "item text" # Add item
node ~/.openclaw/skills/cozi/scripts/cozi.js check <listId> <itemId> # Mark complete
node ~/.openclaw/skills/cozi/scripts/cozi.js uncheck <listId> <itemId> # Mark incomplete
node ~/.openclaw/skills/cozi/scripts/cozi.js remove <listId> <itemId> # Remove item
node ~/.openclaw/skills/cozi/scripts/cozi.js new-list "title" [type] # Create list (shopping|todo)
node ~/.openclaw/skills/cozi/scripts/cozi.js delete-list <listId> # Delete list
# Calendar
node ~/.openclaw/skills/cozi/scripts/cozi.js calendar [year] [month] # Show month (defaults to current)
node ~/.openclaw/skills/cozi/scripts/cozi.js cal [year] [month] # Alias
node ~/.openclaw/skills/cozi/scripts/cozi.js add-appt YYYY-MM-DD HH:MM HH:MM "subject" [location] [notes]
node ~/.openclaw/skills/cozi/scripts/cozi.js remove-appt <year> <month> <apptId>
```
## Examples
```bash
# See all lists and their items
node ~/.openclaw/skills/cozi/scripts/cozi.js lists
# Add milk to the shopping list
node ~/.openclaw/skills/cozi/scripts/cozi.js add abc123 "Organic milk"
# Mark item as bought
node ~/.openclaw/skills/cozi/scripts/cozi.js check abc123 item456
# Create a new todo list
node ~/.openclaw/skills/cozi/scripts/cozi.js new-list "Weekend chores" todo
# View this month's calendar
node ~/.openclaw/skills/cozi/scripts/cozi.js cal
# View specific month
node ~/.openclaw/skills/cozi/scripts/cozi.js cal 2026 3
# Add an appointment
node ~/.openclaw/skills/cozi/scripts/cozi.js add-appt 2026-02-20 14:00 15:30 "Doctor appointment" "Rochester General"
```
## Session Caching
The script caches your session token in `~/.openclaw/skills/cozi/.session.json` to avoid re-authenticating every call. Tokens expire — it will re-auth when needed.
## API Details
- Base URL: `https://rest.cozi.com/api/ext/2207`
- Auth: Bearer token from username/password login
- Lists endpoint: `/api/ext/2004/{accountId}/list/`
Based on [cozi-api-client](https://github.com/BrandCast-Signage/cozi-api-client) and [py-cozi](https://github.com/Wetzel402/py-cozi).Example Workflow
Here's how your AI assistant might use this skill in practice.
INPUT
User asks: Adding groceries to a shared family shopping list
AGENT
- 1Adding groceries to a shared family shopping list
- 2Creating a chore list for the weekend
- 3Checking upcoming appointments on the family calendar
- 4Marking purchased items as done during a store run
- 5Scheduling an appointment with a location and time
OUTPUT
Interact with Cozi Family Organizer (shopping lists, todo lists, item management)
Security Audits
VirusTotalBenign
OpenClawBenign
View full reportThese signals reflect official OpenClaw status values. A Suspicious status means the skill should be used with extra caution.