🗓️ 캘린더 작업을 AI 보조원용 도구로 노출하는 CalDAV 모델 컨텍스트 프로토콜(MCP) 서버입니다.

✨ 특징

• CalDAV 서버에 접속
• 목록 달력
• 특정 시간 내 일정 일정 목록
• 캘린더 이벤트 생성
• 일정 행사 업데이트
• UID로 캘린더 이벤트 삭제

준비

개발

퀵 스타트

자동 재로드와 함께 개발 모드로 MCP 서버를 실행하세요:

이 기능은 TypeScript 코드를 감시 모드로 직접 실행하고 .env에서 환경 변수를 자동으로 불러옵니다.

수동 빌드

또는 TypeScript를 자바스크립트로 컴파일하여 실행할 수도 있습니다:

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)