🗓️ Сервер CalDAV Model Context Protocol (MCP) для предоставления календарных операций в качестве инструментов для AI-ассистентов.

✨ Особенности

• Подключение к серверам CalDAV
• Календари списков
• Список событий календаря в определённом временном промежутке
• Создание событий в календаре
• Обновление событий календаря
• Удаление событий календаря с помощью UID

Подготовка

Развитие

Быстрый старт

Запустите MCP-сервер в режиме разработки с автозагрузкой:

Он запускает код TypeScript напрямую с режимом наблюдения и автоматически загружает переменные среды из .env.

Ручная сборка

В качестве альтернативы можно скомпилировать TypeScript в JavaScript и запустить его:

1. Составить:

2. Беги:

Доступные инструменты

список-календари

Перечислите все календари, возвращающие как имя, так и абсолютный URL. Передайте url календаря без изменений как calendarUrl другим инструментам.

Параметры: отсутствуют

Возвраты:

• Список всех доступных календарей

список-событий

Перечислите все события между датой начала и конца в календаре, указанном по его URL

Параметры:

• calendarUrl: струна
• end: строка — Дата окончания (ISO 8601)
• start: строка — Дата начала (ISO 8601)

Возвраты:

caldav-mcp

✨ Features

• Connect to CalDAV servers
• List calendars
• List calendar events within a specific timeframe
• Create calendar events
• Update calendar events
• Delete calendar events by UID

Setup

{
  "mcpServers": {
    ...,
    "calendar": {
      "command": "npx",
      "args": [
        "caldav-mcp"
      ],
      "env": {
        "CALDAV_BASE_URL": "",
        "CALDAV_USERNAME": "",
        "CALDAV_PASSWORD": ""
      }
    }
  }
}

Development

Quick Start

Run the MCP server in development mode with auto-reload:

npm run dev

This will run the TypeScript code directly with watch mode and automatically load environment variables from .env.

Manual Build

Alternatively, you can compile TypeScript to JavaScript and run it:

1. Compile:

npx tsc

2. Run:

node dist/index.js

Available Tools

list-calendars

List all calendars returning both name and absolute URL. Pass a calendar’s url unchanged as calendarUrl to the other tools.

Parameters: none

Returns:

• List of all available calendars

list-events

List all events between start and end date in the calendar specified by its URL

Parameters:

• calendarUrl: string
• end: string — End date (ISO 8601)
• start: string — Start date (ISO 8601)

Returns:

• A list of events that fall within the given timeframe, each containing uid, summary, start, end, and optionally description and location

create-event

Creates an event in the calendar specified by its URL. For all-day events, set wholeDay to true. For a single-day all-day event, use start and end datetimes on the same calendar date; they do not need to be identical timestamps.

Parameters:

• calendarUrl: string
• description: string (optional)
• end: string — End datetime (ISO 8601)
• location: string (optional)
• recurrenceRule: object (optional)