LC

lukegskw/caldav-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

5 stars 3 forks 품질 82 트렌드 33MIT

A TypeScript MCP server for iCloud Calendar with native multi-VALARM support.

개요

is a Model Context Protocol server for managing iCloud Calendar events, including native support for multiple VALARM reminders on one event. iCloud Calendar is the only provider officially supported and manually validated in the first release. The server works with any MCP client that supports stdio or Streamable HTTP. This independent project is not affiliated with, authorized, sponsored, or approved by Apple Inc. Apple and iCloud are trademarks of their respective owner. Create an Apple app-specific password, then pick the option for your client. download caldav-mcp.mcpb, open it with Claude Desktop, and enter your Apple Account email and app-specific password. See Claude Desktop extension. install Node.js 22 or newer and add this server to a JSON-configured MCP client such as Gemini CLI or Claude Code: Restart the client and confirm that it lists six calendar tools. See client-specific setup and Docker deployment below.

README

원문 README의 일부입니다. 원문 보기.

CalDAV MCP Server

CalDAV MCP Server is a Model Context Protocol server for managing iCloud Calendar events, including native support for multiple VALARM reminders on one event.

iCloud Calendar is the only provider officially supported and manually validated in the first release. The server works with any MCP client that supports stdio or Streamable HTTP.

This independent project is not affiliated with, authorized, sponsored, or approved by Apple Inc. Apple and iCloud are trademarks of their respective owner.

Quick start

Create an Apple app-specific password, then pick the option for your client.

Claude Desktop (one click, no Node.js install): download caldav-mcp.mcpb, open it with Claude Desktop, and enter your Apple Account email and app-specific password. See Claude Desktop extension.

Any other stdio client: install Node.js 22 or newer and add this server to a JSON-configured MCP client such as Gemini CLI or Claude Code:

{
  "mcpServers": {
    "icloud-calendar": {
      "command": "npx",
      "args": ["--yes", "@lukegskw/caldav-mcp@latest"],
      "env": {
        "CALDAV_USERNAME": "[email protected]",
        "CALDAV_PASSWORD": "xxxx-xxxx-xxxx-xxxx"
      }
    }
  }
}

Restart the client and confirm that it lists six calendar tools. See client-specific setup and Docker deployment below. Keep the configuration file private because it contains the app-specific password.

About

GitHub에서 전체 README 보기

설치

npx --yes @lukegskw/caldav-mcp@latest
MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{ "mcpServers": { "icloud-calendar": { "command": "npx", "args": ["--yes", "@lukegskw/caldav-mcp@latest"], "env": { "CALDAV_USERNAME": "[email protected]", "CALDAV_PASSWORD": "xxxx-xxxx-xxxx-xxxx" } } } }