用途:在自托管的 Radicale 服务器上管理日历事件和联系人,基于 CalDAV 与 CardDAV 协议读写数据,适合需要自建日历/通讯录并由 AI 代理代为查询或录入的场景。
主要能力:日历方面可列出日历、按日期范围查看事件、创建事件、按 UID 删除事件;联系人方面可列出通讯录、列出联系人、按名字或邮箱模糊搜索、创建联系人、按 UID 删除联系人。所有操作通过 scripts/radicale-api.py 包装脚本执行,输出 JSON。
使用方式:先安装依赖 pip install caldav vobject icalendar,在 ~/.claude-homelab/.env 配置 RADICALE_URL、RADICALE_USERNAME、RADICALE_PASSWORD 并设置权限 chmod 600。常用命令如 python scripts/radicale-api.py calendars list、events list --calendar "Personal" --start "2026-02-08" --end "2026-02-15"、events create、contacts search、contacts create 等;日期使用 ISO 8601。
限制:创建与删除立即生效且删除不可撤销;无时区支持(使用服务器本地时间);不支持重复事件与提醒;联系人字段仅限姓名、邮箱、电话;建议生产环境使用 HTTPS。缺失信息暂未提供。