icloud-hme

icloud-hme is a Python tool that automates the creation of private email aliases using Apple's Hide My Email feature. If you have an iCloud+ subscription, Apple lets you create disposable @icloud.com addresses that forward to your real inbox. This tool can create those addresses in bulk without visiting the settings page each time.

The tool has two ways to use it. The first is a simple web interface that runs locally in your browser. It shows a dashboard with counts of how many aliases were created today and in total, a list of all your aliases with copy and export options, and controls for the built-in scheduler. The second is a command-line interface for people who prefer working in a terminal or want to run it on a server without a display.

The scheduler is the main feature for unattended use. It runs a job at a random point within 15 minutes of each hour, creates aliases until Apple signals a limit has been reached, then waits for the next cycle. If two consecutive attempts hit the limit immediately, it backs off and retries after about five minutes. All timing uses the time reported by the server over HTTP rather than the local system clock, so it stays accurate even if the machine's clock drifts.

To authenticate, you supply your iCloud session cookies, which you can export from Chrome using a browser extension or let the tool extract automatically on Windows. The cookies are saved locally after the first import so you do not need to paste them again on restart.

The project requires Python 3.10 or newer and an active iCloud+ subscription. It works on Windows, macOS, and Linux. The license is MIT.