MMCPMarkets
LC

lukegskw/caldav-mcp

开发工具

本页由 AI 翻译，技术细节请以原文为准。 查看原文

5 stars 3 forks 质量 82 趋势 33MIT
Repository Install

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
新手？先看 mcpskill.org 教程 →

配置

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