mcpField
F
familyorg

familyorg

本地服务
github.com/CloudCorpRecords生产力01 周前更新
代码仓库

关于 familyorg

familyorg 是面向 Cozi 家庭账户的 MCP 服务，可供 MCP 客户端查询和管理家庭成员、共享清单与日历。它提供读写工具，并可切换为只读模式；其 Cozi API 请求尚未用真实账户验证。

主要功能

  1. 01查询家庭成员与共享清单
  2. 02查看及搜索家庭日历
  3. 03创建和维护清单项目
  4. 04创建、更新及删除预约
  5. 05支持只读模式

适用场景

  1. 01查看家庭购物或待办清单
  2. 02查找家庭日历中的预约
  3. 03管理清单项目与家庭预约

MCP 相关

向 MCP 客户端提供 Cozi 家庭成员、清单和日历的查询与修改工具；设置只读模式后会隐藏写入工具并拒绝写入调用。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "cloudcorprecords-familyorg": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/familyorg"
      ]
    }
  }
}
启动命令npx -y @reneturcios/familyorg

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@reneturcios/familyorg0.1.0
ocighcr.io/cloudcorprecords/familyorg:0.1.0

工具

15

收录的工具列表 · 更新于 1 周前

此工具无需参数。

详细介绍

familyorg

通过 MCP 客户端管理 Cozi 家庭账户：查看家庭成员、全家共享的购物清单和待办清单，以及包含家庭约会的家庭日历。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 可启用只读模式：九个写入工具将从 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 对象参数。

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

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。