Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Ruby library to access Apple's iCloud (Just reminders, for now)
branch: master

Merge pull request #7 from troy/update-put-url

Update PUT URL to include p_guid
latest commit 8050074d1f
Adam Mckaig authored

iCloud Reminders for Ruby

This is a Ruby library to access iCloud reminders.

Try it

git clone
cd ruby-icloud
bundle --path=vendor
bundle exec irb -r icloud
irb(main):001:0> session ="", "passw0rd")
=> #<ICloud::Session:0x10637e040>
irb(main):002:0> session.reminders.first(3).map(:title)
=> ["Disregard females", "Acquire currency", "Do laundry"]


The integration tests hit for real, so to run them, you should set up a separate Apple ID and set the following environment vars:


For now, you must also manually set up the following reminders:

Title: Foo
List: Alpha
Completed: Yes
Title: Bar
List: Alpha
Completed: Yes
Title: One
List: Alpha
Completed: No
Title: Two
List: Alpha
Completed: No
Reminder: 01/02/2015 03:00 PM
Title: Three
List: Beta
Completed: No

I use a totally separate Apple ID for this, because it's entirely possible that this library will trash your calendar, cancel all of your alarms, turn off your grandmother's life support, and so on. I'm aware this this is absurd, but I don't have a better solution right now.


This gem is tested against:

  • Ruby 1.8.7
  • Ruby 1.9.2
  • Ruby 1.9.3
  • Ruby 2.0.0


ruby-icloud is free software, available under the MIT license.

Something went wrong with that request. Please try again.