Component: Calendar 
--------------------

Functions for the Calendar database on macOS. (iCal)

You may have events or todo items in your FileMaker database. Our plugin can help you sync them into the calendar database on Mac, e.g. create events and reminders into specific calendars. If one Mac has a calendar subscribed for each member of staff and those sync via iCloud/Google/Exchange to their mobile phones, your solution can push events or reminders to your staff on one central routine.  
  
The [calendar](component_Calendar.md) functions work on macOS for 32 and 64-bit applications.  
But they are deprecated by Apple and you should move to [Events](component_Events.md) functions for newer projects. Please do not mix Calendar and Events calls as they use different IDs.  
  
On Server you can only use [calendar](component_Calendar.md) functions if you got a calender for the user account where the server runs. Normally the server user account has no calendars.  
  
Use this functions to sync events to iCal/Calendar app.  
  
Deprecated. Please move to [Events](component_Events.md) functions.

| Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|
| [3.4](newinversion34.md "First functions introduced with version 3.4.") / [9.2](newinversion92.md "Newest functions in version 9.2.") | ✅ Yes | ❌ No | ❌ No | ❌ No | ❌ No |

  
| Item | Details |
|:--|:--|
| [Calendar.Alarm.Duplicate](CalendarAlarmDuplicate.md)  **Deprecated**    Creates a copy of an alarm. | Mac only   3.5 |
| [Calendar.Alarm.GetAbsoluteTrigger](CalendarAlarmGetAbsoluteTrigger.md)  **Deprecated**    Queries the absolute trigger timestamp. | Mac only   3.5 |
| [Calendar.Alarm.GetAcknowledged](CalendarAlarmGetAcknowledged.md)  **Deprecated**    Queries acknowledged flag. | Mac only   3.5 |
| [Calendar.Alarm.GetAction](CalendarAlarmGetAction.md)  **Deprecated**    Queries the action for this alarm. | Mac only   3.5 |
| [Calendar.Alarm.GetEmailAddress](CalendarAlarmGetEmailAddress.md)  **Deprecated**    Queries the email address for an alarm. | Mac only   3.5 |
| [Calendar.Alarm.GetRelatedTo](CalendarAlarmGetRelatedTo.md)  **Deprecated**    Queries the related to setting. | Mac only   3.5 |
| [Calendar.Alarm.GetRelativeTrigger](CalendarAlarmGetRelativeTrigger.md)  **Deprecated**    Queries the relative trigger value. | Mac only   3.5 |
| [Calendar.Alarm.GetSound](CalendarAlarmGetSound.md)  **Deprecated**    Queries the sounds for this alarm. | Mac only   3.5 |
| [Calendar.Alarm.GetURL](CalendarAlarmGetURL.md)  **Deprecated**    Queries the URL of the alarm. | Mac only   3.5 |
| [Calendar.Alarm.SetAbsoluteTrigger](CalendarAlarmSetAbsoluteTrigger.md)  **Deprecated**    Sets the absolute trigger timestamp. | Mac only   3.5 |
| [Calendar.Alarm.SetAcknowledged](CalendarAlarmSetAcknowledged.md)  **Deprecated**    Sets acknowledged flag. | Mac only   3.5 |
| [Calendar.Alarm.SetAction](CalendarAlarmSetAction.md)  **Deprecated**    Sets an action for this alarm. | Mac only   3.5 |
| [Calendar.Alarm.SetEmailAddress](CalendarAlarmSetEmailAddress.md)  **Deprecated**    Sets the email address for this alarm. | Mac only   3.5 |
| [Calendar.Alarm.SetRelatedTo](CalendarAlarmSetRelatedTo.md)  **Deprecated**    Sets the related to setting. | Mac only   3.5 |
| [Calendar.Alarm.SetRelativeTrigger](CalendarAlarmSetRelativeTrigger.md)  **Deprecated**    Sets the relative trigger value. | Mac only   3.5 |
| [Calendar.Alarm.SetSound](CalendarAlarmSetSound.md)  **Deprecated**    Sets the sounds for this alarm. | Mac only   3.5 |
| [Calendar.Alarm.SetURL](CalendarAlarmSetURL.md)  **Deprecated**    Sets the URL of the alarm. | Mac only   3.5 |
| [Calendar.Alarm.TriggerDateRelativeTo](CalendarAlarmTriggerDateRelativeTo.md)  **Deprecated**    Queries the relative trigger date for this alarm. | Mac only   3.5 |
| [Calendar.Attendee.GetAddress](CalendarAttendeeGetAddress.md)  **Deprecated**    Returns URL address of attendee entry. | Mac only   3.5 |
| [Calendar.Attendee.GetCommonName](CalendarAttendeeGetCommonName.md)  **Deprecated**    Returns the user-entered name of the attendee. | Mac only   3.5 |
| [Calendar.Attendee.GetStatus](CalendarAttendeeGetStatus.md)  **Deprecated**    Returns status of attendee. | Mac only   3.5 |
| [Calendar.Calendar.Duplicate](CalendarCalendarDuplicate.md)  **Deprecated**    Creates a copy of an existing calendar. | Mac only   3.4 |
| [Calendar.Calendar.GetColor](CalendarCalendarGetColor.md)  **Deprecated**    Queries the color of the calendar. | Mac only   3.4 |
| [Calendar.Calendar.GetNotes](CalendarCalendarGetNotes.md)  **Deprecated**    Queries the notes of the calendar. | Mac only   3.4 |
| [Calendar.Calendar.GetTitle](CalendarCalendarGetTitle.md)  **Deprecated**    Queries the title of the calendar. | Mac only   3.4 |
| [Calendar.Calendar.GetType](CalendarCalendarGetType.md)  **Deprecated**    Queries the type of the calendar. | Mac only   3.4 |
| [Calendar.Calendar.GetUID](CalendarCalendarGetUID.md)  **Deprecated**    Queries the UID of a calendar. | Mac only   3.4 |
| [Calendar.Calendar.IsEditable](CalendarCalendarIsEditable.md)  **Deprecated**    Whether calendar is editable. | Mac only   3.4 |
| [Calendar.Calendar.SetColor](CalendarCalendarSetColor.md)  **Deprecated**    Sets the color for a calendar. | Mac only   3.4 |
| [Calendar.Calendar.SetNotes](CalendarCalendarSetNotes.md)  **Deprecated**    Sets the notes for the calendar. | Mac only   3.4 |
| [Calendar.Calendar.SetTitle](CalendarCalendarSetTitle.md)  **Deprecated**    Set title of the calendar. | Mac only   3.4 |
| [Calendar.Calendars](CalendarCalendars.md)  **Deprecated**    Returns the list of calendars known to the system. | Mac only   3.4 |
| [Calendar.Events](CalendarEvents.md)  **Deprecated**    Queries events. | Mac only   3.4 |
| [Calendar.Initialize](CalendarInitialize.md)  **Deprecated**    Initializes CalendarStore framework. | Mac only   9.2 |
| [Calendar.Item.AddAlarm](CalendarItemAddAlarm.md)  **Deprecated**    Adds an alarm to a calendar item. | Mac only   3.5 |
| [Calendar.Item.Duplicate](CalendarItemDuplicate.md)  **Deprecated**    Creates a copy of an existing item. | Mac only   3.4 |
| [Calendar.Item.GetAlarms](CalendarItemGetAlarms.md)  **Deprecated**    Queries the list of alarms for this item. | Mac only   3.5 |
| [Calendar.Item.GetAllDay](CalendarItemGetAllDay.md)  **Deprecated**    Queries whether event is all day. | Mac only   3.4 |
| [Calendar.Item.GetAttendeeCommonName](CalendarItemGetAttendeeCommonName.md)  **Deprecated**    Queries name of attendees. | Mac only   3.4 |
| [Calendar.Item.GetAttendeeCount](CalendarItemGetAttendeeCount.md)  **Deprecated**    Queries number of attendees. | Mac only   3.4 |
| [Calendar.Item.GetAttendeeStatus](CalendarItemGetAttendeeStatus.md)  **Deprecated**    Queries status of attendees. | Mac only   3.4 |
| [Calendar.Item.GetAttendeeURL](CalendarItemGetAttendeeURL.md)  **Deprecated**    Queries URL of attendees. | Mac only   3.4 |
| [Calendar.Item.GetAttendees](CalendarItemGetAttendees.md)  **Deprecated**    Queries the list of attendees for this event. | Mac only   3.5 |
| [Calendar.Item.GetCalendar](CalendarItemGetCalendar.md)  **Deprecated**    Queries the calendar id for this calendar item. | Mac only   3.4 |
| [Calendar.Item.GetCompleted](CalendarItemGetCompleted.md)  **Deprecated**    Queries the completed flag for a reminder. | Mac only   3.4 |
| [Calendar.Item.GetCompletionDate](CalendarItemGetCompletionDate.md)  **Deprecated**    Queries the completion date. | Mac only   3.4 |
| [Calendar.Item.GetDateStamp](CalendarItemGetDateStamp.md)  **Deprecated**    Queries date stamp for this event. | Mac only   3.4 |
| [Calendar.Item.GetDueDate](CalendarItemGetDueDate.md)  **Deprecated**    Queries due date of this reminder/task. | Mac only   3.4 |
| [Calendar.Item.GetEndDate](CalendarItemGetEndDate.md)  **Deprecated**    Queries the end date of an event. | Mac only   3.4 |
| [Calendar.Item.GetLocation](CalendarItemGetLocation.md)  **Deprecated**    Queries the location for the event. | Mac only   3.4 |
| [Calendar.Item.GetNotes](CalendarItemGetNotes.md)  **Deprecated**    Queries the notes of the calendar item. | Mac only   3.4 |
| [Calendar.Item.GetPriority](CalendarItemGetPriority.md)  **Deprecated**    Queries the priority of a task/reminder. | Mac only   3.4 |
| [Calendar.Item.GetStartDate](CalendarItemGetStartDate.md)  **Deprecated**    Queries the start date of an event. | Mac only   3.4 |
| [Calendar.Item.GetTitle](CalendarItemGetTitle.md)  **Deprecated**    Queries the title of the event or reminder. | Mac only   3.4 |
| [Calendar.Item.GetUID](CalendarItemGetUID.md)  **Deprecated**    Queries the unique identifier for a new calendar item. | Mac only   3.4 |
| [Calendar.Item.GetURL](CalendarItemGetURL.md)  **Deprecated**    Queries the URL of a calendar item. | Mac only   3.4 |
| [Calendar.Item.HasAlarm](CalendarItemHasAlarm.md)  **Deprecated**    Whether this calendar item has an alarm. | Mac only   3.4 |
| [Calendar.Item.IsDetached](CalendarItemIsDetached.md)  **Deprecated**    Whether event is detached. | Mac only   3.4 |
| [Calendar.Item.NextAlarmDate](CalendarItemNextAlarmDate.md)  **Deprecated**    Queries date of next alarm. | Mac only   3.4 |
| [Calendar.Item.Occurrence](CalendarItemOccurrence.md)  **Deprecated**    Returns the occurrence date of an event. | Mac only   3.4 |
| [Calendar.Item.RemoveAlarm](CalendarItemRemoveAlarm.md)  **Deprecated**    Removes an alarm from an item. | Mac only   3.5 |
| [Calendar.Item.SetAllDay](CalendarItemSetAllDay.md)  **Deprecated**    Sets the all day flag for an event. | Mac only   3.4 |
| [Calendar.Item.SetCalendar](CalendarItemSetCalendar.md)  **Deprecated**    Assigns a calendar to the calendar item. | Mac only   3.4 |
| [Calendar.Item.SetCompleted](CalendarItemSetCompleted.md)  **Deprecated**    Sets the completed flag for a reminder. | Mac only   3.4 |
| [Calendar.Item.SetCompletionDate](CalendarItemSetCompletionDate.md)  **Deprecated**    Sets a new completion date for a reminder. | Mac only   3.4 |
| [Calendar.Item.SetDueDate](CalendarItemSetDueDate.md)  **Deprecated**    Sets due date of a reminder/task. | Mac only   3.4 |
| [Calendar.Item.SetEndDate](CalendarItemSetEndDate.md)  **Deprecated**    Sets the end date of an event. | Mac only   3.4 |
| [Calendar.Item.SetLocation](CalendarItemSetLocation.md)  **Deprecated**    Sets a location for an event. | Mac only   3.4 |
| [Calendar.Item.SetNotes](CalendarItemSetNotes.md)  **Deprecated**    Sets the notes for this item. | Mac only   3.4 |
| [Calendar.Item.SetPriority](CalendarItemSetPriority.md)  **Deprecated**    Sets the priority of a task/reminder. | Mac only   3.4 |
| [Calendar.Item.SetStartDate](CalendarItemSetStartDate.md)  **Deprecated**    Sets the start date of an event. | Mac only   3.4 |
| [Calendar.Item.SetTitle](CalendarItemSetTitle.md)  **Deprecated**    Sets the title of the event or reminder. | Mac only   3.4 |
| [Calendar.Item.SetURL](CalendarItemSetURL.md)  **Deprecated**    Assigns a new URL for a calendar item. | Mac only   3.4 |
| [Calendar.NewAlarm](CalendarNewAlarm.md)  **Deprecated**    Creates a new alarm. | Mac only   3.5 |
| [Calendar.NewCalendar](CalendarNewCalendar.md)  **Deprecated**    Creates a new calendar. | Mac only   3.4 |
| [Calendar.NewEvent](CalendarNewEvent.md)  **Deprecated**    Creates a new event. | Mac only   3.4 |
| [Calendar.NewReminder](CalendarNewReminder.md)  **Deprecated**    Creates a new reminder. | Mac only   3.4 |
| [Calendar.Notification.Clear](CalendarNotificationClear.md)  **Deprecated**    Clears the registered notification script. | Mac only   3.5 |
| [Calendar.Notification.Evaluate](CalendarNotificationEvaluate.md)  **Deprecated**    Installs a notification evaluation. | Mac only   6.2 |
| [Calendar.Notification.GetChangedExternally](CalendarNotificationGetChangedExternally.md)  **Deprecated**    Queries if the last notification script call was caused by a changed in another app. | Mac only   3.5 |
| [Calendar.Notification.GetDeletedRecords](CalendarNotificationGetDeletedRecords.md)  **Deprecated**    Queries list of deleted records. | Mac only   3.5 |
| [Calendar.Notification.GetInsertedRecords](CalendarNotificationGetInsertedRecords.md)  **Deprecated**    Queries list of inserted records. | Mac only   3.5 |
| [Calendar.Notification.GetProcessID](CalendarNotificationGetProcessID.md)  **Deprecated**    Queries the process ID. | Mac only   3.5 |
| [Calendar.Notification.GetProcessName](CalendarNotificationGetProcessName.md)  **Deprecated**    Queries the process name. | Mac only   3.5 |
| [Calendar.Notification.GetUpdatedRecords](CalendarNotificationGetUpdatedRecords.md)  **Deprecated**    Queries list of updated records. | Mac only   3.5 |
| [Calendar.Notification.GetUserUID](CalendarNotificationGetUserUID.md)  **Deprecated**    Queries the user ID. | Mac only   3.5 |
| [Calendar.Notification.GetWhat](CalendarNotificationGetWhat.md)  **Deprecated**    Queries what changed in the database. | Mac only   3.5 |
| [Calendar.Notification.Set](CalendarNotificationSet.md)  **Deprecated**    Installs a notification script. | Mac only   3.5 |
| [Calendar.RemoveCalendar](CalendarRemoveCalendar.md)  **Deprecated**    Deletes the calendar. | Mac only   3.4 |
| [Calendar.RemoveEvent](CalendarRemoveEvent.md)  **Deprecated**    Deletes the event. | Mac only   3.4 |
| [Calendar.RemoveReminder](CalendarRemoveReminder.md)  **Deprecated**    Deletes the reminder. | Mac only   3.4 |
| [Calendar.SaveCalendar](CalendarSaveCalendar.md)  **Deprecated**    Saves the calendar. | Mac only   3.4 |
| [Calendar.SaveEvent](CalendarSaveEvent.md)  **Deprecated**    Saves the event. | Mac only   3.4 |
| [Calendar.SaveReminder](CalendarSaveReminder.md)  **Deprecated**    Saves the reminder. | Mac only   3.4 |
| [Calendar.SelectEvent](CalendarSelectEvent.md)  **Deprecated**    Selects an event with occurrance for editing. | Mac only   3.4 |
| [Calendar.Tasks](CalendarTasks.md)  **Deprecated**    Queries all tasks. | Mac only   3.4 |
| [Calendar.TasksCompletedSince](CalendarTasksCompletedSince.md)  **Deprecated**    Queries tasks completed since a given date. | Mac only   3.4 |
| [Calendar.UncompletedTasks](CalendarUncompletedTasks.md)  **Deprecated**    Queries all uncompleted tasks. | Mac only   3.4 |
| [Calendar.UncompletedTasksDueBefore](CalendarUncompletedTasksDueBefore.md)  **Deprecated**    Queries tasks completed before a given date. | Mac only   3.4 |

99 functions shown.

These functions require a license (100%).

### Release notes

- **Version 15.0**
    - Deprecated [Calendar](https://www.mbsplugins.eu/component_Calendar.shtml) functions. Please move to [Events](https://www.mbsplugins.eu/component_Events.shtml) functions.
- **Version 9.2**
    - Added [Calendar.Initialize](http://www.mbsplugins.eu/CalendarInitialize.shtml) function.
    - Changed plugin to not link to [EventKit](https://www.mbsplugins.eu/component_Events.shtml) functions, [CalendarStore](https://www.mbsplugins.eu/component_Calendar.shtml) and [TWAIN](https://www.mbsplugins.eu/component_Twain.shtml) frameworks directly.
- **Version 9.0**
    - Improved out of bounds error message for [Menu.InsertItem](http://www.mbsplugins.eu/MenuInsertItem.shtml), [Menu.RemoveItemAtIndex](http://www.mbsplugins.eu/MenuRemoveItemAtIndex.shtml), [Calendar.Item.GetAttendeeURL](http://www.mbsplugins.eu/CalendarItemGetAttendeeURL.shtml), [Calendar.Item.GetAttendeeCommonName](http://www.mbsplugins.eu/CalendarItemGetAttendeeCommonName.shtml), [Calendar.Item.GetAttendeeStatus](http://www.mbsplugins.eu/CalendarItemGetAttendeeStatus.shtml), [Printer.PrinterName](http://www.mbsplugins.eu/PrinterPrinterName.shtml) and [CLGeocoder.PlacemarkValue](http://www.mbsplugins.eu/CLGeocoderPlacemarkValue.shtml).
- **Version 8.4**
    - Marked Events, Addressbook, Contacts and [Calendar](http://www.mbsplugins.eu/component_Calendar.shtml) functions to not work on server as looks impossible now to get the permissions for privacy to make them work for FileMaker Server on MacOS.
- **Version 8.3**
    - Added ReturnAsNumbers parameter for [Calendar.Calendar.GetColor](http://www.mbsplugins.eu/CalendarCalendarGetColor.shtml), [Events.Calendar.GetColor](http://www.mbsplugins.eu/EventsCalendarGetColor.shtml), [SyntaxColoring.GetScriptHighlightColor](http://www.mbsplugins.eu/SyntaxColoringGetScriptHighlightColor.shtml), [SyntaxColoring.GetScriptIfColor](http://www.mbsplugins.eu/SyntaxColoringGetScriptIfColor.shtml), [SyntaxColoring.GetScriptLoopColor](http://www.mbsplugins.eu/SyntaxColoringGetScriptLoopColor.shtml), [SyntaxColoring.GetScriptSearchColor](http://www.mbsplugins.eu/SyntaxColoringGetScriptSearchColor.shtml) and [SyntaxColoring.LineNumbers.GetColor](http://www.mbsplugins.eu/SyntaxColoringLineNumbersGetColor.shtml).
- **Version 8.2**
    - Fixed [Calendar.Calendar.GetColor](http://www.mbsplugins.eu/CalendarCalendarGetColor.shtml) function.

### Blog Entries

- [MBS @ FMTraining.TV - 25 Ways to Improve Your Database Using the FileMaker MonkeyBread Plug-in - Day 2](https://www.mbsplugins.de/archive/2025-01-23/MBS_@_FMTrainingTV_-_25_Ways_t/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Advent calendar - Door 16 - Add Entries In Apple Calendar](https://www.mbsplugins.de/archive/2024-12-16/MBS_FileMaker_Advent_calendar_/monkeybreadsoftware_blog_filemaker)
- [Limited access to calendars on macOS Sonoma](https://www.mbsplugins.de/archive/2023-10-12/Limited_access_to_calendars_on/monkeybreadsoftware_blog_filemaker)
- [macOS Privacy and FileMaker](https://www.mbsplugins.de/archive/2020-08-11/macOS_Privacy_and_FileMaker/monkeybreadsoftware_blog_filemaker)
- [Contact picker and viewer for FileMaker](https://www.mbsplugins.de/archive/2020-01-31/Contact_picker_and_viewer_for_/monkeybreadsoftware_blog_filemaker)
- [New Contacts functions for FileMaker](https://www.mbsplugins.de/archive/2018-08-08/New_Contacts_functions_for_Fil/monkeybreadsoftware_blog_filemaker)
- [Import Calendar Items into FileMaker](https://www.mbsplugins.de/archive/2017-11-03/Import_Calendar_Items_into_Fil/monkeybreadsoftware_blog_filemaker)
- [Todo/Reminder Synchronization for FileMaker on Mac using MBS Plugin](https://www.mbsplugins.de/archive/2016-09-22/TodoReminder_Synchronization_f/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin 6.2 for OS X/Windows](https://www.mbsplugins.de/archive/2016-05-24/MBS_FileMaker_Plugin_62_for_OS/monkeybreadsoftware_blog_filemaker)
- [FileMaker and Calendar (iCal)](https://www.mbsplugins.de/archive/2016-04-23/FileMaker_and_Calendar_(iCal)/monkeybreadsoftware_blog_filemaker)

### FileMaker Magazin

- [Ausgabe 1/2014, Seite 31 bis 33](https://filemaker-magazin.de/neuigkeit/3720-Appetithappen-FMM_201401)

### Example Databases

- [Mac and iOS/Events/Calendar/Calendar Changes](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/Mac%20and%20iOS/Events/Calendar/Calendar%20Changes.shtml#1ScriptAnchor_)
- [Mac and iOS/Events/Calendar/Calendar Events](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/Mac%20and%20iOS/Events/Calendar/Calendar%20Events.shtml#1ScriptAnchor_)
- [Mac and iOS/Events/Calendar/Calendar Import](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/Mac%20and%20iOS/Events/Calendar/Calendar%20Import.shtml#1ScriptAnchor_)
- [Mac and iOS/Events/Calendar/Calendar Test](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/Mac%20and%20iOS/Events/Calendar/Calendar%20Test.shtml#1ScriptAnchor_)
- [Mac and iOS/Events/Calendar/Reminders](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/Mac%20and%20iOS/Events/Calendar/Reminders.shtml#1ScriptAnchor_)

[HTML Version](component_Calendar.shtml)