icloud-headless-mcp
Servidor MCP headless para iCloud que permite a agentes de IA acceder a Mail, Calendario, Contactos, Notas y Recordatorios sin Mac. Usa Chrome headless para sincronización web segura con aprobaciones explícitas para escrituras críticas.
Ficha actualizada 26 sept 2026, 14:21 · upstream 26 sept 2026, 14:09 · release latest
Qué es icloud-headless-mcp
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este proyecto implementa un servidor MCP (Model Context Protocol) auto-alojado que expone la interfaz de iCloud a agentes de IA mediante protocolos abiertos o aplicaciones web controladas. Elimina la dependencia de macOS, ejecutándose en Linux, VPS o Raspberry Pi con una sola binaria compilada en Go. La arquitectura separa el acceso a datos estructurados (CalDAV, CardDAV, IMAP) del manejo de interfaces complejas (Notas y Recordatorios), que se gestionan mediante un navegador Chrome headless persistente.
La seguridad es central en su diseño: no expone puertos de red permanentes, utiliza credenciales específicas para aplicaciones revocables desde la cuenta Apple y requiere aprobación explícita del usuario para cualquier acción destructiva o visible (enviar correos, borrar notas). La sesión se mantiene localmente en el servidor, permitiendo que los agentes consulten datos sin exponer credenciales primarias ni mantener sesiones inactivas en redes externas.
- Agentes de IA gestionando agendas y recordatorios personales a través de protocolos estándar
- Automatización de respuestas de correo electrónico con revisión humana previa al envío
- Sincronización de notas entre dispositivos sin necesidad de mantener un Mac encendido
- Integración en flujos de trabajo de productividad que requieren acceso a datos de iCloud desde servidores Linux
- Herramienta para desarrolladores que necesitan acceder a APIs de Apple sin dependencias del ecosistema macOS
- Soporte nativo para protocolos abiertos (IMAP, CalDAV, CardDAV) y aplicaciones web headless
- Sistema de aprobaciones explícitas en el cliente MCP para todas las escrituras críticas
- Binaria única compilada en Go sin dependencias de contenedores Docker ni sistemas complejos
- Gestión segura de sesiones mediante credenciales específicas para aplicaciones revocables
- Capacidad de autenticación remota mediante enlace temporal con navegador headless visible
- Requiere instalación manual de Go y Chrome/Chromium en el sistema anfitrión
- No soporta escritura directa en CalDAV Reminders debido a limitaciones de Apple
- Lectura de correo no marca mensajes como vistos para evitar alteraciones del estado
- Dependencia de la zona horaria del servidor para sincronización precisa de recordatorios
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Instalar vía `go install` o script one-line en servidores Linux. Configurar variables `ICLOUD_APPLE_ID` y `ICLOUD_APP_PASSWORD`. Ajustar `requestTimeoutMs` a 330000 para operaciones web lentas. Definir `AGENT_TZ` si el servidor usa UTC. Ejecutar como servicio con cuenta de usuario dedicada para aislamiento de seguridad.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.