Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old


Queries matching contacts for a name.

Component Version macOS Windows Linux Server iOS SDK
Contacts 8.4 ✅ Yes ❌ No ❌ No ❌ No ✅ Yes
MBS( "CNContactStore.ContactsMatchingName"; Name )   More


Parameter Description Example
Name The name to match against. "Joe Miller"


Returns list or error.


Queries matching contacts for a name.
Returns list of contact identifiers.

This will use unified contacts, so data is merged from several sources.


Query name of first contact found with given name:

MBS("CNContact.Name"; GetValue ( MBS( "CNContactStore.ContactsMatchingName"; "Joe Miller" ); 1))

See also

Release notes

Example Databases

Blog Entries

This function checks for a license.

Created 1st August 2018, last changed 21st September 2018

CNContactStore.ContactsMatchingEmailAddress - CNContactStore.ContactsMatchingPhoneNumber