iClonud

Tu correo, calendario y contactos de iCloud en Android y en Claude Code, con protocolos abiertos.

Página del proyecto: https://killernet2003.github.io/iclonud/

iClonud tiene dos partes que usan los mismos servidores oficiales de iCloud:

	Qué es	Carpeta
📱 App de Android	Kotlin + Jetpack Compose. Correo, calendario y contactos nativos, y accesos a Notas, Fotos, iCloud Drive, Recordatorios y Buscar por iCloud.com.	android/
🤖 Servidor MCP	Le da a Claude Code (o a cualquier cliente MCP) herramientas para tu correo, calendario y contactos de iCloud.	mcp/

Servicio	Protocolo	Servidor
Correo	IMAP + SMTP	imap.mail.me.com:993 · smtp.mail.me.com:587
Calendario	CalDAV	caldav.icloud.com
Contactos	CardDAV	contacts.icloud.com

Seguridad y privacidad

• Se entra con el Apple ID y una contraseña específica de app, el método oficial de Apple para clientes externos. Tu contraseña normal del Apple ID nunca se usa.
• No hay servidor intermedio: la app y el MCP hablan solo con los servidores de Apple, por TLS.
• En Android la contraseña se guarda cifrada con el Android Keystore. En el MCP se lee de un archivo local con permisos 600.
• La contraseña específica de app se puede revocar cuando quieras en account.apple.com, sin cambiar tu contraseña principal.

Instalar la app

1. Descarga iclonud-<versión>.apk desde Releases.
2. Ábrelo en el teléfono y permite «instalar apps de origen desconocido» si Android lo pide.
3. Crea una contraseña específica de app (ver abajo) y entra con tu Apple ID.

Huella SHA-256 del certificado de firma, para verificar el APK (apksigner verify --print-certs iclonud-*.apk):

EA:0C:FF:5C:92:2A:86:21:08:60:B4:5F:8B:73:B6:E0:7A:8E:FE:F3:8C:84:1A:B9:39:04:2F:44:E8:D8:C1:87

Usar el MCP en Claude Code

Requiere uv. Las dependencias se instalan solas.

git clone https://github.com/Killernet2003/iclonud.git
claude mcp add --scope user icloud -- uv run --quiet --script "$PWD/iclonud/mcp/icloud_mcp.py"

Luego escribe tus credenciales en ~/.config/iclonud-mcp/credenciales.env (detalles en mcp/README.md) y pídele a Claude, por ejemplo: «resume mis correos sin leer de iCloud».

La contraseña específica de app

1. Entra en account.apple.com → Inicio de sesión y seguridad → Contraseñas de aplicaciones. Requiere la verificación en dos pasos activada.
2. Crea una, por ejemplo «iClonud». Apple te muestra algo como abcd-efgh-ijkl-mnop.
3. Úsala en la app o en el archivo de credenciales del MCP.

Límites honestos

El correo solo funciona si tu cuenta tiene una dirección @icloud.com activa (en el iPhone: Ajustes → tu nombre → iCloud → Correo de iCloud). Si tu Apple ID es de otro dominio (Gmail, Hotmail…) y nunca creaste esa dirección, el calendario y los contactos funcionan, pero el correo no.

Apple no ofrece protocolo abierto para Fotos, iCloud Drive, Notas, Recordatorios ni Buscar. iClonud no usa APIs privadas ni técnicas de scraping: la pestaña iCloud de la app los abre en iCloud.com, la web oficial de Apple, dentro de una pestaña segura de Chrome. Inicias sesión en la página de Apple y la app nunca ve esa contraseña.

Compilar desde el código

cd android
./gradlew assembleDebug        # o ábrelo en Android Studio

El APK de publicación se firma con una llave que no está en el repositorio. Sin ella, assembleRelease genera un APK sin firmar.

Licencia

MIT. Proyecto independiente: no está afiliado, patrocinado ni aprobado por Apple Inc. iCloud es una marca de Apple Inc.