yandex-calendar-mcp

MCP-сервер для Яндекс Календаря. Подключается по CalDAV к caldav.yandex.ru и даёт модели доступ к событиям, задачам и занятости коллег: чтение всегда, запись только в режиме write.

1. Получить пароль приложения

Яндекс не пускает в CalDAV по основному паролю аккаунта, нужен отдельный пароль приложения.

1. Открыть https://id.yandex.ru/security/app-passwords, залогинившись в Яндекс ID.
2. В блоке «Создать пароль приложения» выбрать тип «Календарь».
3. Ввести любое название, например mcp, и нажать «Далее».
4. Скопировать пароль из всплывающего окна. Он показывается один раз.
5. Пароль может заработать не сразу, Яндекс просит подождать до 2–3 часов.

Для Яндекс 360 для бизнеса логин это полный адрес на домене компании (user@company.ru). Если в организации запрещены пароли приложений, запрет снимает администратор.

Источник: инструкция Яндекса по синхронизации календаря.

2. Подключить

Нужен uv: команда uvx скачает пакет с PyPI и запустит его. Переменные окружения:

Claude Code, только чтение:

claude mcp add yandex-calendar \
  -e YANDEX_CALDAV_EMAIL=login@yandex.ru \
  -e YANDEX_CALDAV_KEY=пароль_приложения \
  -- uvx yandex-calendar-mcp@latest

Claude Code, с записью (YANDEX_CALDAV_MODE=write включает тулы создания, изменения и удаления):

claude mcp add yandex-calendar \
  -e YANDEX_CALDAV_EMAIL=login@yandex.ru \
  -e YANDEX_CALDAV_KEY=пароль_приложения \
  -e YANDEX_CALDAV_MODE=write \
  -- uvx yandex-calendar-mcp@latest

Claude Desktop и другие клиенты с JSON-конфигом:

{
  "mcpServers": {
    "yandex-calendar": {
      "command": "uvx",
      "args": ["yandex-calendar-mcp@latest"],
      "env": {
        "YANDEX_CALDAV_EMAIL": "login@yandex.ru",
        "YANDEX_CALDAV_KEY": "пароль_приложения",
        "YANDEX_CALDAV_MODE": "readonly"
      }
    }
  }
}

Codex CLI (конфиг ~/.codex/config.toml):

codex mcp add yandex-calendar \
  --env YANDEX_CALDAV_EMAIL=login@yandex.ru \
  --env YANDEX_CALDAV_KEY=пароль_приложения \
  --env YANDEX_CALDAV_MODE=readonly \
  -- uvx yandex-calendar-mcp@latest

То же самое руками в ~/.codex/config.toml:

[mcp_servers.yandex-calendar]
command = "uvx"
args = ["yandex-calendar-mcp@latest"]

[mcp_servers.yandex-calendar.env]
YANDEX_CALDAV_EMAIL = "login@yandex.ru"
YANDEX_CALDAV_KEY = "пароль_приложения"
YANDEX_CALDAV_MODE = "readonly"

Cursor: Settings → MCP → Add new global MCP server, либо файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в корне проекта. Пароль можно не писать в файл, а взять из переменной окружения через ${env:...}:

{
  "mcpServers": {
    "yandex-calendar": {
      "type": "stdio",
      "command": "uvx",
      "args": ["yandex-calendar-mcp@latest"],
      "env": {
        "YANDEX_CALDAV_EMAIL": "login@yandex.ru",
        "YANDEX_CALDAV_KEY": "${env:YANDEX_CALDAV_KEY}",
        "YANDEX_CALDAV_MODE": "readonly"
      }
    }
  }
}

Точка входа yandex-calendar-mcp-ro всегда поднимает режим чтения, что бы ни стояло в YANDEX_CALDAV_MODE:

uvx --from yandex-calendar-mcp@latest yandex-calendar-mcp-ro

Запуск из исходников и проверка подключения описаны в docs/DEVELOPMENT.md.

3. Тулы

Даты принимаются в ISO 8601: 2026-10-09 означает весь день, 2026-10-09T15:00 точный момент в таймзоне YANDEX_CALDAV_TZ. calendar_id берётся из list_calendars; без него запрос идёт по всем календарям.

Чтение

Запись (только в режиме write)

Правило для встреч. Перед create_event и перед переносом через update_event модель обязана вызвать check_availability для всех участников на нужный слот. При пересечении (BUSY или BUSY-TENTATIVE) встреча не ставится молча: модель показывает пересечения и общие свободные окна и уточняет у пользователя. Правило зашито в instructions сервера и в описания обоих тулов.

Подробности поведения, архитектура и особенности Yandex CalDAV: docs/DEVELOPMENT.md.