Once in a while it may be useful to add some reminders to Reminders.app from the command line — especially because they are synced to iCloud. Is there any way to do so?

A solution that does not rely on AppleScript is preferred: a) for performance reasons (probably silly) and b) AppleScript solutions often feel clumsy or overly verbose to me.

  • 2
    Why do you prefer not to use AppleScript? – Daniel Oct 11 '12 at 1:24
osascript - title <<END
on run a
tell app "Reminders"
tell list "Reminders" of default account
make new reminder with properties {name:item 1 of a}

You could also create an Automator workflow with just an empty New Reminders Item action and then run it with automator -i title test.workflow.

See also this post at Mac OS X Hints.

  • Thank you for your answer. Unfortunately, this does not run in either a shell script or in Script Editor. What am I missing? – myhd Oct 11 '12 at 7:27
  • 1
    Either add #!/usr/bin/env bash as the first line and run chmod +x /path/to/script, or run bash /path/to/script.sh. Or remove the first and last lines and save it AppleScript Editor. – Lri Oct 11 '12 at 15:43
  • 1
    The Automator hint did the trick! In contrast to the AppleScript solution it does not need to launch the Reminders.app, which is exactly what I wanted. – myhd Oct 16 '12 at 9:00
  • Where can I find some docs about the supported applications and what I can tell them? – faressoft Feb 6 '20 at 13:54

Here's another version that allows you to set the title, end date and time via command line arguments.

#!/usr/bin/env bash                                                                                                               
# Make a new reminder via terminal script                                                                                         
# args: remind <title> <date> <time>                                                                                                                                                                                 

osascript - "$1" "$2" "$3" <<END                                                                                                        
on run argv                                                                                                                       
    set stringedAll to date (item 2 of argv & " " & item 3 of argv)                                                               
    tell application "Reminders"                                                                                                  
        make new reminder with properties {name:item 1 of argv, due date:stringedAll}                                             
    end tell                                                                                                                      
end run                                                                                                                           

So if you were to name this script "remind" and give it executing privileges (chmod 755 remind), you could do this:

$ ./remind "Go to grocery store" 12/15/2013 10:00:00PM                              
  • This works for me, but how can I add an alarm. That is how can I make it actually popup and remind me at the date and time of the reminder? As it is, I have a reminder, but do not receive a notification. – GrouchyGaijin Aug 18 '16 at 5:30

Here's the same functionality as the above AppleScript; but in JXA with ES6.

#!/usr/bin/env osascript -l JavaScript

const RemindersApp = Application('Reminders');

function run(argv) {
    [name, date, time] = argv;
    dueDate = new Date(date + " " + time);
    reminder = RemindersApp.Reminder({name: name, dueDate: dueDate});
  • Where can I find some docs about the supported applications and the methods? – faressoft Feb 6 '20 at 13:54
tell application "Reminders"
    show list "Reminders"
end tell
set stringedDate to "12/11/2015"
set stringedHour to "10:00:00PM"
set stringedAll to date (stringedDate & " " & stringedHour)
tell application "Reminders" to tell list "Reminders" of default account to make new reminder with properties {name:"this is just test remainder", remind me date:stringedAll, due date:stringedAll, priority:1}
  • 1
    Hi, thanks! This does only work on Systems where English is the User Interface language. In other Languages, a the list names are localized, e.g. "Reminders" becomes "Erinnerungen" in German – myhd Apr 7 '15 at 13:32
  • This example actually illustrates the use of the "remind me date" as opposed to the "due date" above. And the "remind me date" is exactly what one wants to use to get the alarm/alert. – Grrrr Aug 31 '16 at 11:19

This github project works great, and doesnt use AppleScript. It's a compiled XCode app.


You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .