使用说明
caldav mcp
MCP服务器，用于通过CalDAV进行人工智能日历访问。适用于Claude Desktop和其他MCP客户端。
特性
- 列出多个CalDAV帐户中的日历和事件
- 创建、更新和删除日历事件（带确认）
- 检查日程安排冲突（展开重复事件）
- 使用工作时间过滤器建议可用时段
- 解析
.ics日历邀请文件 - 操作系统密钥链凭据存储（无明文秘密）
安装
自制（macOS）
brew tap honest-magic/tap
brew install caldav-mcp
npm
npm install -g @honest-magic/caldav-mcp
npx（不安装）
npx @honest-magic/caldav-mcp accounts add
设置
1.添加CalDAV帐户
caldav-mcp accounts add
帐户ID、服务器URL、用户名和密码的交互式提示。密码存储在您的操作系统钥匙链中。连接会自动测试。
常见服务器URL：
- Icloud：
https://caldav.icloud.com（使用a 应用程序特定密码) - 谷歌
https://apidata.googleusercontent.com/caldav/v2 - 快速邮件：
https://caldav.fastmail.com - Nextcloud：
https://your-server.com/remote.php/dav
2.在克劳德桌面注册
caldav-mcp --install-claude
运行此程序后重新启动Claude Desktop。
3.验证
caldav-mcp --validate-accounts
命令行界面
caldav-mcp [options] [command]
Commands:
accounts add Add a new CalDAV account (interactive)
accounts list List configured accounts
accounts remove ID Remove an account
Options:
--validate-accounts Probe CalDAV connections and exit
--install-claude Write caldav-mcp to Claude Desktop config and exit
--version Show version number
-h, --help Show this help message
MCP工具
| 工具 | 说明 |
|---|---|
list_calendars |
列出跨帐户的所有日历 |
list_events |
列出日期范围内的事件（展开重复） |
read_event |
阅读完整的活动详情 |
create_event |
创建新事件（需要确认） |
update_event |
更新现有事件（需要确认+etag） |
delete_event |
删除事件（需要确认+etag） |
check_conflicts |
检查时间范围是否与现有事件冲突 |
suggest_slots |
查找具有可选工作时间的可用时段 |
parse_ics |
解析原始iCalendar数据 |
register_oauth2_account |
注册Google/OAuth2日历帐户 |
需求
- Node.js>=18
- 与CalDAV兼容的日历服务器
许可证
麻省理工学院