← Back to Skills Marketplace
angusthefuzz

Cozi Family Organizer

by angusthefuzz · GitHub ↗ · v1.0.2
cross-platform ✓ Security Clean
709
Downloads
2
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install cozi
Description
Interact with Cozi Family Organizer (shopping lists, todo lists, item management). Unofficial API client for family organization.
README (SKILL.md)

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

# Lists
node ~/.openclaw/skills/cozi/scripts/cozi.js lists                    # Show all lists
node ~/.openclaw/skills/cozi/scripts/cozi.js list \x3ClistId>            # Show specific list
node ~/.openclaw/skills/cozi/scripts/cozi.js add \x3ClistId> "item text"  # Add item
node ~/.openclaw/skills/cozi/scripts/cozi.js check \x3ClistId> \x3CitemId>   # Mark complete
node ~/.openclaw/skills/cozi/scripts/cozi.js uncheck \x3ClistId> \x3CitemId> # Mark incomplete
node ~/.openclaw/skills/cozi/scripts/cozi.js remove \x3ClistId> \x3CitemId>  # 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 \x3ClistId>      # 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 \x3Cyear> \x3Cmonth> \x3CapptId>

Examples

# 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 and py-cozi.

Usage Guidance
This skill appears coherent and implements an unofficial Cozi CLI. Before installing: (1) Understand it requires your Cozi email and password — store them in the skill-level .env (~/.openclaw/skills/cozi/.env) if you want to limit exposure to the agent-level .env. (2) It caches an access token in ~/.openclaw/skills/cozi/.session.json — protect that file (permissions) or remove it to force re-auth. (3) Confirm you are comfortable giving your Cozi credentials to an unofficial client (Cozi may change the API and the client is not official). (4) Verify you have Node installed and review scripts/cozi.js yourself if you want to double-check no unexpected network endpoints or behavior. Overall this skill is internally consistent but exercise standard caution with credentials and third‑party/unofficial clients.
Capability Analysis
Type: OpenClaw Skill Name: cozi Version: 1.0.2 The OpenClaw skill 'cozi' is designed to interact with the Cozi Family Organizer API. The `SKILL.md` provides clear instructions and does not contain any prompt injection attempts or malicious directives. The `scripts/cozi.js` file securely handles `COZI_EMAIL` and `COZI_PASSWORD` by explicitly reading only these variables from `.env` files and uses them to authenticate with the legitimate `rest.cozi.com` API. Session tokens are cached locally within the skill's directory. The script makes standard HTTPS requests and does not contain any code for data exfiltration, unauthorized command execution, persistence, or obfuscation. Its functionality is entirely aligned with its stated purpose.
Capability Assessment
✓ Purpose & Capability
Name/description (Cozi client) match the included code and declared requirements. Required binaries (node) and env vars (COZI_EMAIL, COZI_PASSWORD) are exactly what an unofficial Cozi CLI would need.
✓ Instruction Scope
SKILL.md commands correspond to the CLI actions implemented in scripts/cozi.js. The script only reads COZI_EMAIL and COZI_PASSWORD from skill- or agent-level .env files, caches a session locally, and makes HTTPS requests to rest.cozi.com — all within the stated scope.
✓ Install Mechanism
No install spec or external downloads; this is instruction-only plus an included Node script. No archive downloads or external installers are used.
✓ Credentials
Only two environment variables (COZI_EMAIL, COZI_PASSWORD) are required. The code explicitly filters .env lines to those two keys, so it does not read arbitrary secrets from agent .env files.
✓ Persistence & Privilege
always:false (no forced inclusion). The skill caches the Cozi session token in ~/.openclaw/skills/cozi/.session.json — expected for convenience and limited to the skill's directory. The skill does not modify other skills or global configs.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install cozi
  3. After installation, invoke the skill by name or use /cozi
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
Updated header comments with calendar commands
v1.0.1
Fixed env loading to only read COZI vars
v1.0.0
Initial release
Metadata
Slug cozi
Version 1.0.2
License —
All-time Installs 0
Active Installs 0
Total Versions 3
Frequently Asked Questions

What is Cozi Family Organizer?

Interact with Cozi Family Organizer (shopping lists, todo lists, item management). Unofficial API client for family organization. It is an AI Agent Skill for Claude Code / OpenClaw, with 709 downloads so far.

How do I install Cozi Family Organizer?

Run "/install cozi" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Cozi Family Organizer free?

Yes, Cozi Family Organizer is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Cozi Family Organizer support?

Cozi Family Organizer is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Cozi Family Organizer?

It is built and maintained by angusthefuzz (@angusthefuzz); the current version is v1.0.2.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments