MCP

caldav-mcp: CalDAV 캘린더를 AI 어시스턴트에 연결

CalDAV 서버 계정이 이미 있고 AI 어시스턴트로 캘린더를 조회하고 관리하고 싶은 사용자에게 가장 적합합니다. 서버 주소, 사용자 이름, 비밀번호가 필수이며, 생성·수정·삭제는 운영 중인 캘린더에 바로 기록되므로 실행 전 확인이 필요합니다.

Official source · caldav-mcp

Install

"command": "npx",
      "args": [
        "caldav-mcp"
      ],

누에게 적합한가

  • 이미 CalDAV 서버 계정(직접 구축했거나 서비스 제공자가 제공)이 있고, AI 어시스턴트로 캘린더를 직접 조회하고 관리하고 싶은 사람. 공식은 이 프로젝트를 "캘린더 작업을 AI 어시스턴트용 도구로 노출하는 것"으로 위치짓고 있습니다.
  • 다루는 작업: CalDAV 서버 연결, 캘린더 목록 조회, 기간별 캘린더 이벤트 조회, 이벤트 생성, 수정, UID로 삭제.
  • 사용 전제가 명확합니다: CalDAV 서버 주소, 사용자 이름, 비밀번호가 반드시 필요하며 각각 CALDAV_BASE_URL, CALDAV_USERNAME, CALDAV_PASSWORD 세 환경 변수로 전달합니다. 세 가지 모두 필수입니다.
  • 적합하지 않은 경우: CalDAV 서버가 없거나 계정 자격 증명을 로컬 프로세스에 넘기고 싶지 않은 사람. 공식 문서는 어떤 CalDAV 서버 구현과 호환되는지, 읽기 전용 모드가 있는지 모두 설명하지 않았으며 이 두 가지는 미확인입니다.

3분 만에 첫 시도 완료하기

권장 기본 경로: MCP 클라이언트의 mcpServers 설정에서 npx로 실행합니다. npx가 caldav-mcp 패키지를 자동으로 내려받아 실행합니다. 설정에 다음 조각을 추가합니다:

"command": "npx",
      "args": [
        "caldav-mcp"
      ],

같은 설정에서 환경 변수로 자격 증명을 제공합니다:

"CALDAV_BASE_URL": "<CalDAV server URL>",
        "CALDAV_USERNAME": "<CalDAV username>",
        "CALDAV_PASSWORD": "<CalDAV password>"

저장하고 클라이언트를 재시작한 뒤, 먼저 읽기 작업을 한 번 해보세요: AI 어시스턴트에게 "내 캘린더 목록을 보여줘"라고 요청합니다. 공식 기능 목록의 List calendars에 해당합니다. 성공 신호는 어시스턴트가 해당 계정의 캘린더 목록을 반환하는 것입니다. 이 단계는 캘린더 구조를 읽기만 하고 이벤트를 만들거나 수정하지 않지만, 자격 증명을 사용해 CalDAV 서버에 연결합니다.

반드시 기억하세요: 이 서버의 생성·수정·삭제는 원격 쓰기 작업이며 운영 중인 캘린더를 직접 변경합니다. 쓰기 작업 전에 어시스턴트가 실행할 작업, 대상 이벤트, 대상 필드를 먼저 되풀이하게 하고, 확인 후에 실행하세요.

공식은 개발자용 실행 방법도 제공합니다: TypeScript 코드를 watch 모드로 직접 실행하고 .env에서 환경 변수를 자동으로 불러옵니다. 코드 디버깅에 적합하며, 일상 사용은 위의 npx 기본 경로를 따르세요.

사용 사례

사례 1: 연결 및 권한 확인(List calendars). 상황: 자격 증명을 방금 설정해 주소나 비밀번호가 맞는지 확신이 없음. 방법: 어시스턴트에게 "내 캘린더 목록을 보여줘"라고 요청합니다. 자격 증명을 검증하는 가장 저렴한 읽기 작업입니다. 기대 결과: 해당 CalDAV 계정의 캘린더 목록이 반환됩니다. 실패하면 세 환경 변수 값을 확인한 뒤 다시 시도하세요.

사례 2: update-event로 필요한 필드만 수정. 상황: 회의 시간만 바뀌고 제목·장소 등 나머지 정보는 그대로. 방법: 어시스턴트가 대상 이벤트를 찾게 한 뒤 update-event를 호출하고, 수정할 필드만 전달합니다. 공식 설명은 "기존 캘린더 이벤트를 수정합니다. 제공된 필드만 변경됩니다"입니다. 기대 결과: 제공한 필드만 갱신되고 나머지는 그대로 유지됩니다. 확인 지점: 원격 쓰기 작업으로 변경이 CalDAV 서버에 바로 반영되므로, 실행 전 대상 이벤트와 수정할 필드를 반드시 확인하세요.

사용 한계

  • 읽기/쓰기 성격: 기능에는 읽기(캘린더 목록, 기간별 이벤트 목록)와 쓰기(생성, 수정, UID로 삭제)가 모두 포함되며, 도구는 운영 중인 캘린더에 직접 작용합니다. 삭제는 UID 단위로 이루어지며, 삭제 후 복구 가능 여부와 되돌리기 경로에 대해 공식 설명이 없으므로 확인 단계에서 각별히 엄격해야 합니다.
  • 자격 증명 요구 사항: 서버 주소, 사용자 이름, 비밀번호는 환경 변수로 제공해야 합니다. OAuth, 앱 전용 비밀번호 같은 대체 인증 지원 여부는 공식 문서에 설명이 없으며 미확인입니다.
  • 부작용과 확인 지점: 쓰기 작업은 서버의 캘린더를 실제로 변경합니다. update-event는 제공된 필드만 수정하며 언급되지 않은 필드는 영향을 받지 않습니다.
  • 기타 미확인 사항: 지원되는 CalDAV 서버 소프트웨어 목록, 속도 제한·동시성 제한 모두 공식 설명이 없습니다. "설명 없음"은 문서의 범위를 나타낼 뿐 안전성에 대한 결론이 아닙니다.