Ruby library to access Apple's iCloud (Just reminders, for now)
Switch branches/tags
Nothing to show
Latest commit 8a9418a Mar 26, 2016 @troy troy Merge pull request #13 from ReadmeCritic/patch-1
Improve README
Failed to load latest commit information.
lib Enable Marshal.dump of session Jun 1, 2015
script Add script/test runner Jan 11, 2013
test Add Record.has_many Mar 28, 2013
.gitignore Replace 'rake reminders' with 'bin/icloud-reminders' Jan 23, 2013
.ruby-version working with ruby 2.0.0 Oct 27, 2013
.travis.yml working with ruby 2.0.0 Oct 27, 2013
LICENSE Split into a proper gem. Apr 6, 2012 Improve README Mar 26, 2016
icloud.gemspec Remove Mechanize dependency Mar 10, 2013

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)
=> ["Grocery shopping", "Acquire currency", "Do laundry"]


The integration tests hit for real, so to run them, you should set up a separate [Apple ID] appleid 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] travis:

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


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