README.md

iCloud.js

iCloud.js is an independent project, and is not affiliated, endorsed, recommended by or otherwise affiliated with Apple Inc.

iCloud.js is a library for interacting with Apple's iCloud services for Node.js.

Thanks

This library would not be possible without the help of:

• pyicloud
• iCloud Photos Sync

Usage

Check the examples, or read the API reference

Basic example

// for TypeScript, use:
import iCloud from "icloudjs";
// for JavaScript, use:
const { default: iCloud } = require('icloudjs');


const icloud = new iCloud({
    username: "[email protected]",
    password: "hunter2",
    saveCredentials: true,
    trustDevice: true,
    authMethod: "srp"
})
await icloud.authenticate()
console.log(icloud.status)
if (icloud.status === "MfaRequested") {
    await icloud.provideMfaCode("123456")
}
await icloud.awaitReady;
console.log("Hello, " + icloud.accountInfo.dsInfo.fullName)
return icloud