Component: Contacts 
--------------------

The newer Apple API for Addressbook/Contacts access.

For 64-bit MacOS and iOS to work with addressbook and multiple accounts.  
Replaces older deprecated [Addressbook](component_Addressbook.md) functions.

| Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|
| [8.4](newinversion84.md "First functions introduced with version 8.4.") / [16.3](newinversion163.md "Newest functions in version 16.3.") | ✅ Yes | ❌ No | ❌ No | ❌ No | ✅ 88% |

  
| Item | Details |
|:--|:--|
| [CNContact.AddEmailAddress](CNContactAddEmailAddress.md)   Adds an email address to a contact. | Mac/iOS   8.4 |
| [CNContact.AddInstantMessage](CNContactAddInstantMessage.md)   Adds an instant message account to a contact. | Mac/iOS   8.4 |
| [CNContact.AddInstantMessageJSON](CNContactAddInstantMessageJSON.md)   Adds an instant message account to a contact with JSON. | Mac/iOS   8.4 |
| [CNContact.AddPhoneNumber](CNContactAddPhoneNumber.md)   Adds an phone number to a contact. | Mac/iOS   8.4 |
| [CNContact.AddPostalAddress](CNContactAddPostalAddress.md)   Adds an postal address to a contact. | Mac/iOS   8.4 |
| [CNContact.AddPostalAddressJSON](CNContactAddPostalAddressJSON.md)   Adds an postal address to a contact with JSON. | Mac/iOS   8.4 |
| [CNContact.AddRelation](CNContactAddRelation.md)   Adds an relation to a contact. | Mac/iOS   8.4 |
| [CNContact.AddSocialProfile](CNContactAddSocialProfile.md)   Adds an social profile to a contact. | Mac/iOS   8.4 |
| [CNContact.AddSocialProfileJSON](CNContactAddSocialProfileJSON.md)   Adds an social profile to a contact with JSON. | Mac/iOS   8.4 |
| [CNContact.AddURLAddress](CNContactAddURLAddress.md)   Adds an URL address to a contact. | Mac/iOS   8.4 |
| [CNContact.DeleteValue](CNContactDeleteValue.md)   Deletes a value of a contact. | Mac/iOS   10.1 |
| [CNContact.EditInAddressbook](CNContactEditInAddressbook.md)   Launches Contacts application to edit this person. | Mac only   8.4 |
| [CNContact.HasValue](CNContactHasValue.md)   Checks whether a value is available in the loaded contact. | Mac/iOS   12.1 |
| [CNContact.IsUnifiedWithContact](CNContactIsUnifiedWithContact.md)   Checks if the contact is unified based on other contact. | Mac/iOS   8.5 |
| [CNContact.JSON](CNContactJSON.md)   Queries contact as JSON. | Mac/iOS   8.4 |
| [CNContact.MailingAddress](CNContactMailingAddress.md)   Queries mailing address for contact. | Mac/iOS   8.4 |
| [CNContact.Name](CNContactName.md)   Queries display name of contact. | Mac/iOS   8.4 |
| [CNContact.SetValue](CNContactSetValue.md)   Sets the value of a contact. | Mac/iOS   8.4 |
| [CNContact.Show](CNContactShow.md)   Shows a contact as sheet. | Mac/iOS   10.1 |
| [CNContact.ShowInAddressbook](CNContactShowInAddressbook.md)   Launches Contacts application to show this person. | Mac only   8.4 |
| [CNContact.UnifiedContacts](CNContactUnifiedContacts.md)   Queries which contacts an unified contact is based upon. | Mac/iOS   8.5 |
| [CNContact.Value](CNContactValue.md)   Queries the value of contact. | Mac/iOS   8.4 |
| [CNContactPicker.Close](CNContactPickerClose.md)   Closes the picker. | Mac/iOS   10.1 |
| [CNContactPicker.Current](CNContactPickerCurrent.md)   Queries the current contact. | Mac/iOS   10.1 |
| [CNContactPicker.CurrentProperties](CNContactPickerCurrentProperties.md)  **New in 16.3**    Queries the properties selected in the picker. | Mac/iOS   16.3 |
| [CNContactPicker.GetDisplayedKeys](CNContactPickerGetDisplayedKeys.md)  **New in 16.3**    Queries the list of keys to display. | Mac/iOS   16.3 |
| [CNContactPicker.SetDisplayedKeys](CNContactPickerSetDisplayedKeys.md)  **New in 16.3**    Sets what keys to display in the picker. | Mac/iOS   16.3 |
| [CNContactPicker.SetTrigger](CNContactPickerSetTrigger.md)   Sets the script trigger. | Mac/iOS   10.1 |
| [CNContactPicker.Show](CNContactPickerShow.md)   Shows the contact picker to select a contact. | Mac/iOS   10.1 |
| [CNContactStore.AddContact](CNContactStoreAddContact.md)   Adds a new contact to the database. | Mac/iOS   8.4 |
| [CNContactStore.AddGroup](CNContactStoreAddGroup.md)   Adds a new group. | Mac/iOS   8.4 |
| [CNContactStore.AddMember](CNContactStoreAddMember.md)   Add a new member to a group. | Mac/iOS   8.4 |
| [CNContactStore.AddSubgroup](CNContactStoreAddSubgroup.md)   Adds a group to an existing group. | Mac only   8.4 |
| [CNContactStore.AuthorizationError](CNContactStoreAuthorizationError.md)   Queries error message. | Mac/iOS   8.4 |
| [CNContactStore.AuthorizationStatus](CNContactStoreAuthorizationStatus.md)   Queries authorization status. | Mac/iOS   8.4 |
| [CNContactStore.ChangeHistory](CNContactStoreChangeHistory.md)   Queries history changes in the contacts database. | Mac/iOS   15.1 |
| [CNContactStore.Contacts](CNContactStoreContacts.md)   Queries all contacts. | Mac/iOS   8.5 |
| [CNContactStore.ContactsInContainer](CNContactStoreContactsInContainer.md)   Queries list of contacts in a container. | Mac/iOS   8.4 |
| [CNContactStore.ContactsInGroup](CNContactStoreContactsInGroup.md)   Queries contacts in the group. | Mac/iOS   8.4 |
| [CNContactStore.ContactsMatchingEmailAddress](CNContactStoreContactsMatchingEmailAddress.md)   Find the contacts whose email address matches the specified value. | Mac/iOS   10.5 |
| [CNContactStore.ContactsMatchingName](CNContactStoreContactsMatchingName.md)   Queries matching contacts for a name. | Mac/iOS   8.4 |
| [CNContactStore.ContactsMatchingPhoneNumber](CNContactStoreContactsMatchingPhoneNumber.md)   Find the contacts whose phone number matches the specified value. | Mac/iOS   10.5 |
| [CNContactStore.ContactsMatchingURL](CNContactStoreContactsMatchingURL.md)   Find the contacts whose URL matches the specified value. | Mac/iOS   14.0 |
| [CNContactStore.ContactsWithData](CNContactStoreContactsWithData.md)   Creates contacts for vCard data. | Mac/iOS   8.4 |
| [CNContactStore.ContainerForContact](CNContactStoreContainerForContact.md)   Queries container for a contact. | Mac/iOS   8.4 |
| [CNContactStore.ContainerForGroup](CNContactStoreContainerForGroup.md)   Queries container for a group. | Mac/iOS   8.4 |
| [CNContactStore.Containers](CNContactStoreContainers.md)   Queries identifiers of all containers. | Mac/iOS   8.4 |
| [CNContactStore.Country](CNContactStoreCountry.md)   Returns ISO code for users country. | Mac/iOS   8.4 |
| [CNContactStore.DataWithContacts](CNContactStoreDataWithContacts.md)   Queries data for contacts. | Mac/iOS   8.4 |
| [CNContactStore.DefaultContainerIdentifier](CNContactStoreDefaultContainerIdentifier.md)   The identifier of the default container. | Mac/iOS   8.4 |
| [CNContactStore.DeleteContact](CNContactStoreDeleteContact.md)   Delete a contact from the contact store. | Mac/iOS   8.4 |
| [CNContactStore.DeleteGroup](CNContactStoreDeleteGroup.md)   Deletes a group. | Mac/iOS   8.4 |
| [CNContactStore.FetchContact](CNContactStoreFetchContact.md)   Fetches a fresh copy of this contact. | Mac/iOS   12.1 |
| [CNContactStore.GetTransactionAuthor](CNContactStoreGetTransactionAuthor.md)   Queries the author of transactions. | Mac/iOS   15.1 |
| [CNContactStore.GroupHierarchy](CNContactStoreGroupHierarchy.md)   Queries group hierarchy as JSON. | Mac/iOS   8.5 |
| [CNContactStore.Groups](CNContactStoreGroups.md)   Queries list of all groups. | Mac/iOS   8.4 |
| [CNContactStore.GroupsByName](CNContactStoreGroupsByName.md)   Looks for groups with matching names. | Mac only   8.4 |
| [CNContactStore.GroupsForContact](CNContactStoreGroupsForContact.md)   Searches all groups for a given contact. | Mac only   8.4 |
| [CNContactStore.GroupsInContainer](CNContactStoreGroupsInContainer.md)   Queries all groups in a given container. | Mac only   8.4 |
| [CNContactStore.NewContact](CNContactStoreNewContact.md)   Creates new empty contact. | Mac/iOS   8.4 |
| [CNContactStore.RemoveMember](CNContactStoreRemoveMember.md)   Remove a member from a group. | Mac/iOS   8.4 |
| [CNContactStore.RemoveSubgroup](CNContactStoreRemoveSubgroup.md)   Removes a subgroup from a group. | Mac only   8.4 |
| [CNContactStore.RenameGroup](CNContactStoreRenameGroup.md)   Renames the group. | Mac/iOS   8.4 |
| [CNContactStore.RequestAccesss](CNContactStoreRequestAccesss.md)   Request access to the user's contacts. | Mac/iOS   8.4 |
| [CNContactStore.SetChangeScript](CNContactStoreSetChangeScript.md)   Sets the script to trigger on changes by other applications. | Mac/iOS   8.4 |
| [CNContactStore.SetTransactionAuthor](CNContactStoreSetTransactionAuthor.md)   Set the author of transactions. | Mac/iOS   15.1 |
| [CNContactStore.Subgroups](CNContactStoreSubgroups.md)   Queries subgroups of a group. | Mac only   8.4 |
| [CNContactStore.UnifiedMeContact](CNContactStoreUnifiedMeContact.md)   Queries ID of the your contact. | Mac only   8.4 |
| [CNContactStore.UpdateContact](CNContactStoreUpdateContact.md)   Updates a contact. | Mac/iOS   8.4 |
| [CNContainer.Name](CNContainerName.md)   The name of the container. | Mac/iOS   8.4 |
| [CNContainer.Type](CNContainerType.md)   Queries type of container. | Mac/iOS   8.4 |
| [CNGroup.Name](CNGroupName.md)   Queries group name. | Mac/iOS   8.4 |

72 functions shown.

These functions require a license (64%).

### Release notes

- **Version 10.3**
    - Deprecated [Addressbook](https://www.mbsplugins.eu/component_Addressbook.shtml) functions in favor of [Contacts](https://www.mbsplugins.eu/component_Contacts.shtml) functions.
- **Version 8.4**
    - Added [Contacts](http://www.mbsplugins.eu/component_Contacts.shtml) functions.

### Blog Entries

- [MBS FileMaker Plugin 15.1 News](https://www.mbsplugins.de/archive/2025-03-19/MBS_FileMaker_Plugin_151_News/monkeybreadsoftware_blog_filemaker)
- [MBS @ FMTraining.TV - 25 Ways to Improve Your Database Using the FileMaker MonkeyBread Plug-in - Day 1](https://www.mbsplugins.de/archive/2025-01-18/MBS_@_FMTrainingTV_-_25_Ways_t/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Advent calendar - Door 5 - Apple Contacts](https://www.mbsplugins.de/archive/2024-12-05/MBS_FileMaker_Advent_calendar_/monkeybreadsoftware_blog_filemaker)
- [Read and write notes in Contacts](https://www.mbsplugins.de/archive/2023-11-19/Read_and_write_notes_in_Contac/monkeybreadsoftware_blog_filemaker)
- [macOS Privacy and FileMaker](https://www.mbsplugins.de/archive/2020-08-11/macOS_Privacy_and_FileMaker/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin, version 10.3pr5](https://www.mbsplugins.de/archive/2020-06-20/MBS_FileMaker_Plugin_version_1/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)
- [Neues MBS FileMaker Plugin 8.4 - Über 5400 Funktionen in einem Plugin](https://www.mbsplugins.de/archive/2018-09-25/Neues_MBS_FileMaker_Plugin_84_/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin, version 8.4pr2](https://www.mbsplugins.de/archive/2018-08-10/MBS_FileMaker_Plugin_version_8/monkeybreadsoftware_blog_filemaker)
- [New Contacts functions for FileMaker](https://www.mbsplugins.de/archive/2018-08-08/New_Contacts_functions_for_Fil/monkeybreadsoftware_blog_filemaker)

[HTML Version](component_Contacts.shtml)