ricloud-py: iCloud access made easy

pypi CircleCI docs

This is the Python client for ricloud, Reincubate's Cloud Data API.

Refer to the comprehensive ricloud documentation for a fuller picture of the API's capabilities, specifications, and benefits. See also the Apple iCloud service documentation for its rich capabilities in accessing iCloud data.


The library can be installed with a single command:

$ pip install ricloud

Note the version is specified explicitly above, that is because this version is currently in beta.


A sample script is included which provides an example of how the API can be used to access a range of datatypes in a way that is compatible with Apple's 2FA mechanism.

Before you can start using the API you will need to get setup with an access token. More details on getting started with the API can be found in the docs.

To run the sample script in interactive mode, execute the following command:

$ ricloud samples icloud john.appleseed@reincubate.com

More details on how to use the ricloud-py client can be found in our docs.


See the support & service status page.

Need more functionality?

Reincubate's vision is to provide data access, extraction and recovery technology for all app platforms - be they mobile, desktop, web, appliance or in-vehicle.

The company was founded in 2008 and was first to market with both iOS and iCloud data extraction technology. With over half a decade's experience helping law enforcement and security organisations access iOS data, Reincubate has licensed software to government, child protection and corporate clients around the world.

The company can help users with:

Contact Reincubate for more information.

Terms & license

See the LICENSE.md file for details on this implementation's license. Users must not use the API in any way that is unlawful, illegal, fraudulent or harmful; or in connection with any unlawful, illegal, fraudulent or harmful purpose or activity.