caldav-mcp

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.

• 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.)

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

You can also run the server directly without installing it:

uvx mcp-caldav

pip install -e .

Set the following environment variables:

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

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://calda