familyorg

familyorg

MCP クライアントから Cozi の家族アカウントを操作できます。家族のメンバー、家族全員で共有する買い物リストと To Do リスト、予定が登録された家族のカレンダーを確認できます。familyorg は、非公式の cozi_mcp サーバーで文書化された機能を、新しい名前でクリーンルーム方式により再構築したものです。公開されているツール仕様に基づいてコードを新たに作成しており、コードやブランドの流用はありません。

これは非公式のクライアントです。Cozi とは提携していません。

ツール（文書化された全 15 件）

読み取り：family_members、get_lists、get_list_items、today、get_calendar、search_calendar。

書き込み：create_list、rename_list、delete_list、add_item、update_item、remove_items、create_appointment、update_appointment、delete_appointment。

各ツールに関する注意事項：

• get_lists は、任意の list_type として shopping または todo を指定できます。get_list_items は list_id と、任意の include_completed を受け取ります。
• today はローカル時刻のみを参照して応答します。Cozi の認証情報は不要で、ネットワークへのリクエストも行いません。
• create_appointment は subject、start、end と、任意の attendees、all_day、notes、location、repeat、reminders、notify を受け取ります。repeat は、繰り返しの頻度、間隔、曜日、月ごとのルール、終了日などを記述する汎用オブジェクトです。
• update_appointment と delete_appointment は、appointment_id、year、month をキーにします。更新時には指定されたフィールドのみを送信します。また、どちらも繰り返しの予定に対する scope や occurrence_day などの範囲指定フィールドを受け取ります。

セットアップ

認証は Cozi の Web API の方式に従います。ログイン時にユーザー名とパスワードをトークンと交換し、そのトークンを各リクエストに付けて送信します。

export [email protected]
export COZI_PASSWORD=your-password

必要に応じて COZI_API_URL で API のベース URL を上書きできます（デフォルトは https://rest.cozi.com です）。ユーザー名またはパスワードが設定されていない場合、today を除くすべてのツールは、不足している変数名を示すエラーで失敗します。

COZI_READ_ONLY=true を設定すると、読み取り専用モードで実行できます。この場合、書き込みツール 9 件は MCP ツール一覧から消え、書き込みの呼び出しはすべて拒否されます。

rest.cozi.com に対するリクエストとレスポンスの整形は、文書化されたツールの機能をもとに再構築したものであり、実際の Cozi アカウントでは検証されていません。

CLI

npx @reneturcios/familyorg get_calendar '{"year":2026,"month":11}'
npx @reneturcios/familyorg today '{}'
npx @reneturcios/familyorg mcp        # stdio MCP server

各ツール名はサブコマンドで、引数として JSON オブジェクトを 1 つ受け取ります。

MCP クライアントの設定

{
  "mcpServers": {
    "familyorg": {
      "command": "npx",
      "args": ["-y", "@reneturcios/familyorg", "mcp"],
      "env": {
        "COZI_USERNAME": "[email protected]",
        "COZI_PASSWORD": "your-password"
      }
    }
  }
}

Docker

docker run -i -e COZI_USERNAME -e COZI_PASSWORD ghcr.io/cloudcorprecords/familyorg

開発

npm install
npm run build
npm test

ライセンス

MIT