← 返回 Skills 市场

Cozi Family Organizer

Name: Cozi Family Organizer
Author: angusthefuzz

作者 angusthefuzz · GitHub ↗ · v1.0.2

cross-platform ✓ 安全检测通过

709

总下载

当前安装

版本数

在 OpenClaw 中安装

/install cozi

功能描述

Interact with Cozi Family Organizer (shopping lists, todo lists, item management). Unofficial API client for family organization.

使用说明 (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.

安全使用建议

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.

功能分析

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.

能力评估

✓ 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.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install cozi
安装完成后，直接呼叫该 Skill 的名称或使用 /cozi 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

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

元数据

Slug cozi

版本 1.0.2

许可证 —

累计安装 0

当前安装数 0

历史版本数 3

常见问题