MinerU
Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.
iCloud Calendar over CalDAV: list, create, update, move and delete events. Optional read-only mode.
Skills que enseñan a la IA este tipo de trabajo; funcionan junto a este
Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.
A privacy-first app that strips AI watermarks from content you own.
Agent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.
Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes
| Popularidad | 0/80 | Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20 |
|---|---|---|
| Actualidad | 12/12 | Puntuación completa con una versión o cambio de código en 30 días |
| Sigue respondiendo | 0/8 | El endpoint en la nube respondió en la última revisión |
| Puntuación de uso | 12/100 |
Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)
Elige la app de IA que usas y copia la configuración.
Que tu IA lo instale con una frase
Instala iCloud Calendar (CalDAV). Sigue https://mcp.popnx.com/i/glob0x17-mcp-icloud-caldav.md, enséñame los comandos y espera mi OK antes de ejecutarlos.Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA
Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 14 nov 2026
Primero: ¿qué IA usas?
Elige tu app y los pasos aparecen abajo.
Funciona con Claude, pero hay que preparar algo antes
Necesitas una clave de iCloud Calendar (CalDAV) (créala en el sitio del autor) · 1 ajuste(s) que rellenar (ICLOUD_USERNAME) · Instala Python (uv) en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server iCloud Calendar (CalDAV) para Claude en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "icloud-caldav": { "command": "uvx", "args": [ "mcp-icloud-caldav" ], "env": { "ICLOUD_USERNAME": "your-value", "ICLOUD_PASSWORD": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En ICLOUD_PASSWORD, ICLOUD_USERNAME deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de iCloud Calendar (CalDAV) aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.
ICLOUD_USERNAME Apple ID email addressLas descripciones siguen en el inglés original.
SettingsDeveloperEdit Config
{
"mcpServers": {
"icloud-caldav": {
"command": "uvx",
"args": [
"mcp-icloud-caldav"
],
"env": {
"ICLOUD_USERNAME": "your-value",
"ICLOUD_PASSWORD": "your-value"
}
}
}
}Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa iCloud Calendar (CalDAV) y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude dice que está usando iCloud Calendar (CalDAV) o muestra una herramienta de iCloud Calendar (CalDAV) en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
MCP_ICAL_READ_ONLY Establezca en true para omitir las herramientas de crear, actualizar y eliminar. MCP_ICAL_LOG_LEVEL Nivel de registro en stderr: TRACE, DEBUG, INFO, WARNING o ERROR Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
ChatGPT todavía no puede conectar iCloud Calendar (CalDAV)
iCloud Calendar (CalDAV) se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web
A · Usa una app que pueda conectar iCloud Calendar (CalDAV)
Funciona con Claude Code, pero hay que preparar algo antes
Necesitas una clave de iCloud Calendar (CalDAV) (créala en el sitio del autor) · 1 ajuste(s) que rellenar (ICLOUD_USERNAME) · Instala Python (uv) en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server iCloud Calendar (CalDAV) para Claude Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user icloud-caldav --env ICLOUD_USERNAME=your-value --env ICLOUD_PASSWORD=your-value -- uvx mcp-icloud-caldav 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En ICLOUD_PASSWORD, ICLOUD_USERNAME deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de iCloud Calendar (CalDAV) aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.
ICLOUD_USERNAME Apple ID email addressLas descripciones siguen en el inglés original.
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
claude mcp add --scope user icloud-caldav --env ICLOUD_USERNAME=your-value --env ICLOUD_PASSWORD=your-value -- uvx mcp-icloud-caldavCambia “your-value” por tu clave antes de pulsar Enter
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Deberías ver iCloud Calendar (CalDAV) en la lista como conectado
Usa iCloud Calendar (CalDAV) y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude Code dice que está usando iCloud Calendar (CalDAV) o muestra una herramienta de iCloud Calendar (CalDAV) en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
MCP_ICAL_READ_ONLY Establezca en true para omitir las herramientas de crear, actualizar y eliminar. MCP_ICAL_LOG_LEVEL Nivel de registro en stderr: TRACE, DEBUG, INFO, WARNING o ERROR Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con Cursor, pero hay que preparar algo antes
Necesitas una clave de iCloud Calendar (CalDAV) (créala en el sitio del autor) · 1 ajuste(s) que rellenar (ICLOUD_USERNAME) · Instala Python (uv) en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server iCloud Calendar (CalDAV) para Cursor en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "icloud-caldav": { "command": "uvx", "args": [ "mcp-icloud-caldav" ], "env": { "ICLOUD_USERNAME": "your-value", "ICLOUD_PASSWORD": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En ICLOUD_PASSWORD, ICLOUD_USERNAME deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de iCloud Calendar (CalDAV) aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.
ICLOUD_USERNAME Apple ID email addressLas descripciones siguen en el inglés original.
En la configuración de iCloud Calendar (CalDAV), ICLOUD_PASSWORD, ICLOUD_USERNAME está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa iCloud Calendar (CalDAV) y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Cursor dice que está usando iCloud Calendar (CalDAV) o muestra una herramienta de iCloud Calendar (CalDAV) en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
MCP_ICAL_READ_ONLY Establezca en true para omitir las herramientas de crear, actualizar y eliminar. MCP_ICAL_LOG_LEVEL Nivel de registro en stderr: TRACE, DEBUG, INFO, WARNING o ERROR Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con VS Code, pero hay que preparar algo antes
Necesitas una clave de iCloud Calendar (CalDAV) (créala en el sitio del autor) · 1 ajuste(s) que rellenar (ICLOUD_USERNAME) · Instala Python (uv) en tu computadora primero (una sola vez)
Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server iCloud Calendar (CalDAV) para VS Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "icloud-caldav": { "type": "stdio", "command": "uvx", "args": [ "mcp-icloud-caldav" ], "env": { "ICLOUD_USERNAME": "your-value", "ICLOUD_PASSWORD": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En ICLOUD_PASSWORD, ICLOUD_USERNAME deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de iCloud Calendar (CalDAV) aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.
ICLOUD_USERNAME Apple ID email addressLas descripciones siguen en el inglés original.
En la configuración de iCloud Calendar (CalDAV), ICLOUD_PASSWORD, ICLOUD_USERNAME está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa iCloud Calendar (CalDAV) y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si VS Code dice que está usando iCloud Calendar (CalDAV) o muestra una herramienta de iCloud Calendar (CalDAV) en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
MCP_ICAL_READ_ONLY Establezca en true para omitir las herramientas de crear, actualizar y eliminar. MCP_ICAL_LOG_LEVEL Nivel de registro en stderr: TRACE, DEBUG, INFO, WARNING o ERROR Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps
Ver todas las apps que usan MCP →
La configuración JSON está en “Para desarrolladores”, abajo
Claude Code
claude mcp add --scope user icloud-caldav --env ICLOUD_USERNAME=your-value --env ICLOUD_PASSWORD=your-value -- uvx mcp-icloud-caldavClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"icloud-caldav": {
"command": "uvx",
"args": [
"mcp-icloud-caldav"
],
"env": {
"ICLOUD_USERNAME": "your-value",
"ICLOUD_PASSWORD": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"icloud-caldav": {
"command": "uvx",
"args": [
"mcp-icloud-caldav"
],
"env": {
"ICLOUD_USERNAME": "your-value",
"ICLOUD_PASSWORD": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"icloud-caldav": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-icloud-caldav"
],
"env": {
"ICLOUD_USERNAME": "your-value",
"ICLOUD_PASSWORD": "your-value"
}
}
}
}ICLOUD_USERNAME obligatorio envICLOUD_PASSWORD secreto obligatorio envMCP_ICAL_READ_ONLY envMCP_ICAL_LOG_LEVEL envDescripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.
Se ejecutan en tu computadora en
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 19 nov 2026
El nombre en el registro se verificó con la cuenta de GitHub Glob0x17, dueña del repo
Último cambio de código: hace 6 días
Usa MIT
Este se ejecuta en tu computadora; no hay endpoint en internet
Se ejecuta en tu computadora y usa ajustes locales en su lugar
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet
Sin entradas en OSV.dev para mcp-icloud-caldav@0.2.1
Solo revisa esta versión del paquete, no todas sus dependencias · revisado 15 nov 2026
Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.
[](https://mcp.popnx.com/en/servers/glob0x17-mcp-icloud-caldav)Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.
Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.
Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.
Aún no hay reseñas
Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.
Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.
Debes completar: ICLOUD_PASSWORD
Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).
El repo de GitHub cambió por última vez hace 6 días, y la última versión (0.2.1) llegó al registro hace 38 días.
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Python (uv) en tu computadora.
En la misma categoría: Puter MCP, XcodeBuildMCP, Vexa, Atlassian Rovo MCP Server, Anki MCP Server
Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.
Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi
Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more
XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.
Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.
Connect to Atlassian Jira, Confluence, Loom, and more to search, create, and manage your work.
MCP server for Anki flashcards: adaptive review, notes, media, and deck management via AnkiConnect.
| Este iCloud Calendar (CalDAV) | Puter MCP | XcodeBuildMCP | Vexa | Atlassian Rovo MCP Server | Anki MCP Server | |
|---|---|---|---|---|---|---|
| Dónde se ejecuta | Se instala en tu equipo | Funciona en la nube, sin instalar nada | Se instala en tu equipo | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Se instala en tu equipo |
| Necesita clave | Sí | No | No | Sí | No | No |
| Se añade con + en Claude | No | No | No | No | Sí | No |
| Revisiones básicas | 3/3 | 4/4 | 3/3 | 2/4 | 4/4 | 3/3 |
| Licencia | MIT | AGPL-3.0 | MIT | Apache-2.0 | Apache-2.0 | MIT |
| Precio | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro |
Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.
A Model Context Protocol server that gives MCP clients access to iCloud Calendar over CalDAV: list calendars, read, create, update, move and delete events. It works on Linux, macOS and Windows, since it talks to iCloud directly instead of going through the macOS Calendar app.
This is a maintained fork of zwrong/iCalendar, itself derived from the macOS mcp-ical server. See Changes in this fork.
| Tool | Description |
|---|---|
list_calendars | Names of the available calendars |
list_events | Events in a date range, optionally for one calendar, sorted by start time |
create_event | New event: title, times, all-day, location, notes, URL, alarms, recurrence |
update_event | Change any of those fields, or move the event to another calendar |
delete_event | Delete an event by identifier |
debug_calendar_connection | Connection check: calendars and event counts over the last 7 days |
The calendars://list resource also lists the calendars. With MCP_ICAL_READ_ONLY=true, the three write tools are not registered at all.
mcp-icloud-caldav.The username is your Apple ID address, which is not necessarily an @icloud.com address. An app-specific password gives access to iCloud CalDAV, CardDAV and IMAP: keep it out of version control and revoke it if it leaks.
The package is published on PyPI as mcp-icloud-caldav. With uv, MCP clients can start it directly, without a separate install step:
uvx mcp-icloud-caldav
uvx downloads the package into a cached, isolated environment on first use. To install it permanently instead: uv tool install mcp-icloud-caldav (or pipx install mcp-icloud-caldav).
From source:
git clone https://github.com/Glob0x17/mcp-icloud-caldav.git mcp-icloud-caldav
cd mcp-icloud-caldav uv sync --no-dev uv run mcp-icloud-caldav
Credentials are read in this order:
| Variable | Required | Default |
|---|---|---|
ICLOUD_USERNAME | yes | |
ICLOUD_PASSWORD | yes | |
CALDAV_SERVER_URL | no | https://caldav.icloud.com/ |
config.json.exampleOther settings:
| Variable | Default | Effect |
|---|---|---|
MCP_ICAL_READ_ONLY | false | true leaves out create_event, update_event and delete_event |
MCP_ICAL_LOG_LEVEL | INFO | TRACE, DEBUG, INFO, WARNING or ERROR. Logs go to stderr |
The server speaks MCP over stdio and is started by the client. To check it by hand:
ICLOUD_USERNAME=you@example.com ICLOUD_PASSWORD=xxxx-xxxx-xxxx-xxxx uvx mcp-icloud-caldav
It waits on stdin and prints nothing on stdout.
Use the absolute path of uvx (which uvx) if the client cannot find it: clients often start servers without your shell PATH, which shows up as spawn uvx ENOENT. Usual locations:
| Installed with | Path |
|---|---|
| The uv installer (Linux, macOS) | ~/.local/bin/uvx |
| Homebrew on Apple silicon | /opt/homebrew/bin/uvx |
| Homebrew on Intel Macs | /usr/local/bin/uvx |
The command and its argument are separate fields: the command is uvx (or its path) and mcp-icloud-caldav is an argument. A config where the command is the single string "uvx mcp-icloud-caldav" fails with ENOENT, because the client looks for a program with that exact name, space included.
Most clients store env values in clear text in their config file. A small wrapper that reads an env file avoids that:
mkdir -p ~/.config/mcp-icloud-caldav && chmod 700 ~/.config/mcp-icloud-caldav
cat > ~/.config/mcp-icloud-caldav/env <<'EOF' ICLOUD_USERNAME=you@example.com ICLOUD_PASSWORD=xxxx-xxxx-xxxx-xxxx MCP_ICAL_READ_ONLY=true EOF chmod 600 ~/.config/mcp-icloud-caldav/env
cat > ~/.local/bin/mcp-icloud-caldav-run <<'EOF' #!/usr/bin/env bash set -euo pipefail set -a; source "$HOME/.config/mcp-icloud-caldav/env"; set +a exec /absolute/path/to/uvx mcp-icloud-caldav EOF chmod +x ~/.local/bin/mcp-icloud-caldav-run
Then point the client at ~/.local/bin/mcp-icloud-caldav-run. Starting read-only and switching to false once reading works is a sensible first step.
In claude_desktop_config.json (Settings, Developer, Edit Config). On macOS it is ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": { "icloud-calendar": { "command": "uvx", "args": ["mcp-icloud-caldav"], "env": { "ICLOUD_USERNAME": "you@example.com", "ICLOUD_PASSWORD": "xxxx-xxxx-xxxx-xxxx" } } } }
or, with the wrapper, "command": "/home/you/.local/bin/mcp-icloud-caldav-run" and no env. Quit Claude Desktop completely and start it again after editing. On macOS, server logs are in ~/Library/Logs/Claude/mcp-server-icloud-calendar.log.
claude mcp add --scope user icloud-calendar \
-e ICLOUD_USERNAME=you@example.com -e ICLOUD_PASSWORD=xxxx-xxxx-xxxx-xxxx \ -- uvx mcp-icloud-caldav
or, with the wrapper, claude mcp add --scope user icloud-calendar -- ~/.local/bin/mcp-icloud-caldav-run.
Do not quote what follows --: -- uvx mcp-icloud-caldav registers uvx as the command and mcp-icloud-caldav as its argument, while -- "uvx mcp-icloud-caldav" registers one program name and fails with ENOENT. To fix an existing entry, remove it with claude mcp remove icloud-calendar --scope user and add it again.
/mcp in a session shows the server state and its tools; claude mcp get icloud-calendar shows the registered command and arguments.
Any MCP client that can start a stdio server works: run uvx mcp-icloud-caldav with the environment variables above. The server is also listed in the MCP Registry as io.github.Glob0x17/mcp-icloud-caldav.
2030-01-07T09:30:00+01:00) is converted, and a time without one is taken as the machine's local time. Times are shown back in the machine's timezone. All-day events are written as dates, with the end date exclusive as the iCalendar standard requires.update_event with calendar_name uses a WebDAV MOVE, which is atomic on the server: if it fails, the event stays where it was. A move without other changes keeps the original iCalendar data untouched. / .ics URL iCloud uses for most events, and only then to a scan of all calendars. iCloud does not support CalDAV UID searches.repr.DEBUG or below; at INFO, only identifiers. Some clients save server stderr to disk, so keep DEBUG for troubleshooting.uv.lock and resolved from the official PyPI index only.| Symptom | Likely cause |
|---|---|
401 Unauthorized | Regular Apple ID password instead of an app-specific one, or a revoked one |
spawn uvx ENOENT or ENOENT | uvx is not on the client's PATH (use its absolute path), or the command and its argument were registered as one string (see Client setup) |
| No events returned | Wrong date range, an event in a non-iCloud or subscribed calendar, or a timezone mix-up |
| Server does not respond | Something writes to stdout and breaks the stdio protocol |
Calendar 'X' not found | Calendar names are case-sensitive: check list_calendars |
debug_calendar_connection and MCP_ICAL_LOG_LEVEL=DEBUG help narrow things down.
uv sync
uv run pytest -m "not integration" # unit tests, CalDAV client mocked, no network uv run ruff check .
Integration tests run against a real account, read-only, and are skipped unless credentials are set:
ICLOUD_USERNAME=... ICLOUD_PASSWORD=... uv run pytest -m integration
Project layout:
mcp_icloud_caldav/
├── server.py # MCP server, tool registration, logging setup ├── caldav_client.py # CalDAV access: search, create, update, move, delete, event index ├── ical.py # Thin calendar manager used by the server ├── models.py # Event and request models, iCalendar parsing └── config.py # Configuration loading tests/ # Unit tests tests/integration/ # Read-only tests against a real account
0.2.1: documentation only (uvx locations, ENOENT causes, client paths on macOS).
0.2.0, compared with zwrong/iCalendar 0.1.0:
mcp 2.x (FastMCP became MCPServer) and caldav 3.x; the original code no longer starts against current releases.MCP_ICAL_CONFIG, read-only mode, configurable log level, no event contents in logs above DEBUG.Unable to guess TZID); all-day events and recurrence end dates were written incorrectly.mcp-icloud-caldav and listed in the MCP Registry. The Python package and the command are renamed from mcp_ical / mcp-ical, which clashed with the original macOS project. The unused mcp[cli] extra was dropped