LC

lukegskw/caldav-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

6 stars 3 forks 品質 83 トレンド 28MIT

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" } } } }