Для чего этот сервер?

Сервер превращает любой календарь, поддерживающий CalDAV, в инструмент для AI-ассистента. Он позволяет ИИ читать расписание, создавать события с напоминаниями и участниками, искать встречи по тексту или дате — напрямую, без ручного копирования. Работает с Яндекс, Google, Nextcloud, iCloud и другими. Полезен, когда нужно, чтобы ассистент сам управлял календарём и отвечал на вопросы о планах.

Каталог MCP
madbonez/caldav-mcp

madbonez/caldav-mcp

от madbonez

MCP сервер для работы с любыми CalDAV-календарями. Позволяет создавать, получать и удалять события с напоминаниями и участниками. Полезен для автоматизации календарей в MCP-клиентах.

Github PyPi Сайт сервера

README

Инструменты и схема сервера

Версии

Установить сервер

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

Часто задаваемые вопросы

У этого сервера пока нет списка инструментов.

Выберите клиент, чтобы установить madbonez/caldav-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

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

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

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

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

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

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"madbonez-caldav-mcp-cu1k1k7t0l\",\"type\":\"stdio\",\"command\":\"uvx\",\"args\":[\"mcp-caldav\"],\"env\":{\"CALDAV_URL\":\"https://caldav.example.com/\",\"CALDAV_USERNAME\":\"your-username\",\"CALDAV_PASSWORD\":\"your-password\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

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

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add madbonez-caldav-mcp-cu1k1k7t0l --env CALDAV_URL=https://caldav.example.com/ --env CALDAV_USERNAME=your-username --env CALDAV_PASSWORD=your-password -- uvx mcp-caldav

Либо через JSON-конфиг:

claude mcp add-json madbonez-caldav-mcp-cu1k1k7t0l "{\"command\":\"uvx\",\"args\":[\"mcp-caldav\"],\"env\":{\"CALDAV_URL\":\"https://caldav.example.com/\",\"CALDAV_USERNAME\":\"your-username\",\"CALDAV_PASSWORD\":\"your-password\"}}"

Codex

Добавьте сервер командой в терминале:

codex mcp add madbonez-caldav-mcp-cu1k1k7t0l --env CALDAV_URL=https://caldav.example.com/ --env CALDAV_USERNAME=your-username --env CALDAV_PASSWORD=your-password -- uvx mcp-caldav

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.madbonez-caldav-mcp-cu1k1k7t0l]
command = "uvx"
args = ["mcp-caldav"]

[mcp_servers.madbonez-caldav-mcp-cu1k1k7t0l.env]
CALDAV_URL = "https://caldav.example.com/"
CALDAV_USERNAME = "your-username"
CALDAV_PASSWORD = "your-password"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите madbonez/caldav-mcp, а в поле команды запуска — строку ниже:

uvx mcp-caldav

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

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

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

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

Continue

Создайте файл в .continue/mcpServers/ (например madbonez-caldav-mcp-cu1k1k7t0l.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: madbonez-caldav-mcp-cu1k1k7t0l
    command: uvx
    args:
      - "mcp-caldav"
    env:
      CALDAV_URL: https://caldav.example.com/
      CALDAV_USERNAME: your-username
      CALDAV_PASSWORD: your-password

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

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

Конфиг для установки сервера

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

Нужен uvx

Сервер запускается через uvx
Без него ничего работать не будет.

Как установить uvx