CalDAV协议集成的通用MCP服务器. 与任何CalDAV相兼容的日历服务器一起工作,包括Yandex日历,Google日历(通过CalDAV),Nextcloud,自有Cloud,Apple iCloud等.

QQQ快速启动 **: 快速导引以 [[T0] 启动,参见 QUICKSTART.md. QQ ** ursor setup **:详见 CURSOR SETUP.md 光标 IDE 配置指令.

□ 特性

• 列出可用的日历
• 创建带有提醒和参与者的日历活动
• 获得今天、星期或自定义日期范围的活动
• 与任何CalDAV兼容的服务器(Yandex、Google、Nextcloud、自有Cloud、iCloud等)一起工作。

□ 安装

使用 uv(建议)

首先,如果你还没有安装 uv:

macOS/Linux:

** 窗户:**

然后安装工程 :

这将:

• 创建虚拟环境([[T1])
• 安装包括非依赖性在内的所有依赖性
• 生成一个 [[T2] 文件

使用 uvx( 未安装的运行)

您也可以不经安装直接运行服务器 :

使用页码

□ 配置

设置以下环境变量:

CalDAV 服务器 URL

常见 CalDAV 服务器 URL :

• ** Yandex日历**:https://caldav.yandex.ru/

MCP CalDAV Server

Universal MCP server for CalDAV protocol integration. Works with any CalDAV-compatible calendar server including Yandex Calendar, Google Calendar (via CalDAV), Nextcloud, ownCloud, Apple iCloud, and others.

📖 Quick Start: See QUICKSTART.md for a quick guide to get started with uv. 🔧 Cursor Setup: See CURSOR_SETUP.md for detailed Cursor IDE configuration instructions.

Features

• List available calendars
• Create calendar events with reminders and attendees
• Get events for today, week, or custom date range
• Works with any CalDAV-compatible server (Yandex, Google, Nextcloud, ownCloud, iCloud, etc.)

Installation

Using uv (Recommended)

First, install uv if you haven’t already:

macOS/Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Then install the project:

uv sync --dev

This will:

• Create a virtual environment (.venv)
• Install all dependencies including dev dependencies
• Generate a uv.lock file

Using uvx (Run without installation)

You can also run the server directly without installing it:

uvx mcp-caldav

Using pip

pip install -e .

Configuration

Set the following environment variables:

export CALDAV_URL="https://caldav.example.com/"
export CALDAV_USERNAME="your-username"
export CALDAV_PASSWORD="your-password"

CalDAV Server URLs

Common CalDAV server URLs:

• Yandex Calendar: https://caldav.yandex.ru/
• Google Calendar: https://apidata.googleusercontent.com/caldav/v2/ (requires OAuth setup)
• Nextcloud: https://your-domain.com/remote.php/dav/calendars/username/
• ownCloud: https://your-domain.com/remote.php/dav/calendars/username/
• Apple iCloud: https://caldav.icloud.com/ (requires app-specific password)
• FastMail: https://caldav.fastmail.com/dav/calendars/user/

Note: Some servers require app-specific passwords instead of regular passwords. Check your calendar provider’s documentation for CalDAV setup instructions.

Usage

IDE Integration (Cursor)

To use this MCP server in Cursor:

1. Open Cursor Settings → Features → MCP Servers → + Add new global MCP server
2. Add the following configuration:

Using uvx (Recommended - no installation needed):

{
  "mcpServers": {
    "mcp-caldav": {
      "command": "uvx",
      "args": ["mcp-caldav"],
      "env": {
        "CALDAV_URL": "https://caldav.example.com/",
        "CALDAV_USERNAME": "your-username",
        "CALDAV_PASSWORD": "your-password"
      }
    }
  }
}

Using local installation (after uv sync or pip install):

{
  "mcpServers": {
    "mcp-caldav": {
      "command": "mcp-caldav",
      "env": {
        "CALDAV_URL": "https://caldav.example.com/",
        "CALDAV_USERNAME": "your-username",