← 返回目录

CalDAV MCP Server

社区

将CalDAV日历操作作为MCP工具暴露给AI助手。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 团队协作第 29 / 55
Stars: ★ 103 热门
传输方式: stdio（本地进程）
运行环境: Node.js
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 26 天前
工具数: 10

53FMRS · D

该服务器为AI助手提供了通过MCP访问CalDAV日历和任务的能力，功能全面，但需要用户提供CalDAV凭据，存在一定的安全风险。

最强项 · 维护活跃度 13/20 最弱项 · 可靠性 7/20

可靠性

7/20

安全与权限

11/20

维护活跃度

13/20

文档质量

12/20

安装易用性

10/20

查看各项评分依据

可靠性 7/20: 服务器清单和README描述了工具，但静态审查仅提供README生成的工具列表，没有实际源代码来验证实现或测试。没有提供测试证据，CI工作流也未在提供的内容中显示。因此，根据静态审查限制，可靠性评分不超过12，并根据缺乏可验证的测试证据和来源进行扣分。
安全与权限 11/20: 凭据通过环境变量处理，密码标记为秘密。但是，没有提供源代码来检查错误处理或数据最小化。删除操作（删除事件/待办事项）可能没有确认步骤，但存在UID参数。未发现任何红线，但缺乏对安全实践的详细源代码审查，因此评分适中。
维护活跃度 13/20: 仓库有MIT许可证，没有存档，有语义发布和CI徽章。提供了发布工作流。但是，没有提供提交历史或版本详细信息。维护活跃度可从这些信号中推断，但未经证实。
文档质量 12/20: README提供了设置示例、工具参数描述和功能列表。它缺少深入的故障排除、限制和详细的执行示例。文档是可用的，但源代码和生成的文档之外的证据有限。
安装易用性 10/20: 安装是通过npm和npx进行的，并提供了客户端配置示例。环境变量已记录。但是，没有提供执行步骤或平台兼容性测试。说明简单，但复杂性可能因CalDAV服务器而异。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

需要日历集成的AI助手
使用CalDAV兼容服务器的用户
需要任务管理的场景

不适合谁

非CalDAV日历服务（如Google日历直接集成）
需要复杂日历权限管理的用户
对安全性有极高要求且不信任第三方MCP服务器的用户

所需权限

需要访问CalDAV服务器的凭据（用户名和密码）
需要读写日历和任务的能力

风险与副作用

凭据泄露风险：密码可能被存储在配置中
如果MCP客户端被恶意控制，日历数据可能被修改或删除

安装接入

准备工作

运行环境：Node.js

CALDAV_BASE_URL 必填 CalDAV 服务器的基础 URL，例如 https://caldav.example.com，由你的日历服务提供商提供。

CALDAV_USERNAME 必填 CalDAV 认证用户名，通常是日历服务的账户名。

CALDAV_PASSWORD 必填密钥 CalDAV 认证密码，建议使用日历服务提供的应用专用密码，属敏感信息。

在MCP客户端配置中添加以下配置：

{
  "mcpServers": {
    "calendar": {
      "command": "npx",
      "args": ["caldav-mcp"],
      "env": {
        "CALDAV_BASE_URL": "<CalDAV服务器URL>",
        "CALDAV_USERNAME": "<CalDAV用户名>",
        "CALDAV_PASSWORD": "<CalDAV密码>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "calendar": {
      "command": "npx",
      "args": ["caldav-mcp"],
      "env": {
        "CALDAV_BASE_URL": "<CalDAV server URL>",
        "CALDAV_USERNAME": "<CalDAV username>",
        "CALDAV_PASSWORD": "<CalDAV password>"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "calendar": {
      "command": "npx",
      "args": [
        "caldav-mcp"
      ],
      "env": {
        "CALDAV_BASE_URL": "<CalDAV server URL>",
        "CALDAV_USERNAME": "<CalDAV username>",
        "CALDAV_PASSWORD": "<CalDAV password>"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add calendar -e 'CALDAV_BASE_URL=<CalDAV server URL>' -e 'CALDAV_USERNAME=<CalDAV username>' -e 'CALDAV_PASSWORD=<CalDAV password>' -- npx caldav-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

安装并配置环境变量后，在客户端工具列表中应出现 list-calendars、list-events、create-event 等 10 个工具；调用 list-calendars 能返回日历名称和 URL 即说明与 CalDAV 服务器的连接正常。

常见排障

检查CALDAV_BASE_URL是否正确，是否为有效的CalDAV端点
验证用户名和密码是否有效
确保网络可以访问CalDAV服务器

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出我在 CalDAV 服务器上的所有日历
帮我查看下周一到周五日历里的所有事件
在主日历里创建一个周五下午两点的会议事件，地点是会议室A
把我待办清单里所有今天到期未完成的任务列出来

工具能力 10

list-calendars 只读

列出所有日历，返回名称和URL。

list-events 只读

列出指定时间范围内的事件。

create-event 写入

在指定日历中创建事件。

update-event 写入

更新已有事件。

delete-event 破坏性

按UID删除事件。

list-todos 只读

列出任务（VTODO），可筛选状态和日期。

create-todo 写入

创建任务。

update-todo 写入

更新任务。

展开其余 2 个工具

complete-todo 写入

将任务标记为已完成。

delete-todo 破坏性

删除任务。

使用场景

AI助手可以查询和处理日历事件

创建和管理任务待办事项

与CalDAV服务器集成以自动管理日程

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

CalDAV MCP服务器是一个Model Context Protocol（MCP）服务器，将日历操作（如列出、创建、更新和删除事件）作为工具提供给AI助手。它支持CalDAV服务器，允许AI助手管理日历事件和任务（VTODO）。