---
id: pyobjc-framework-contactsui
version: "12.2.2"
license: MIT
license_treatment: permissive
maintenance: active
---

# pyobjc-framework-ContactsUI — Wrappers for the framework ContactsUI on macOS

License: permissive · Maintenance: active · Downloads: 657.0K/mo

## What it is and what it does

This package wraps Apple's ContactsUI framework for macOS, making it available to Python developers via PyObjC. It allows you to programmatically interact with the system's contact picker and related UI components that let users select and manage contacts. The wrapper translates between Python and Objective-C, handling the low-level details of framework communication.

Because it is a thin binding layer rather than a high-level abstraction, you will need to consult both Apple's official ContactsUI documentation and PyObjC's general documentation on Objective-C translation to use it effectively. The package is actively maintained and supports modern Python versions (3.10 through 3.15) on macOS with universal2 architecture.

Use it for:

- Build a macOS app that lets users pick contacts from the system address book via a native UI dialog.
- Integrate contact selection into a Python-based macOS utility or automation script.
- Access ContactsUI framework features from a PyObjC-based desktop application on macOS.
- Programmatically interact with the Contacts app's UI components in a macOS workflow.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides Python bindings to macOS's ContactsUI framework, enabling programmatic access to the system's contact picker and contact-related user interface components.

Yes, if you are developing a macOS application in Python and need native contact picker functionality. The package is actively maintained, has no known vulnerabilities, and carries a permissive MIT license. Install friction is moderate due to platform specificity and compiled dependencies, but this is unavoidable for any framework binding. Not applicable for non-macOS development.

## Install

pip install pyobjc-framework-contactsui
uv add pyobjc-framework-contactsui
poetry add pyobjc-framework-contactsui

## Installing pyobjc-framework-ContactsUI

Before you install: Medium install friction due to platform specificity and compiled wheels. Actively maintained with a release 3 days old; requires macOS 10.11 or later and Python 3.10+. Wheels available for Python 3.10 through 3.15 on universal2 architecture.

License in practice: MIT license permits commercial and private use with minimal restrictions; you may use, modify, and distribute this package freely provided you retain the license notice.

Quickstart:

pip install pyobjc-framework-contactsui

from ContactsUI import CNContactPickerViewController
# Use ContactsUI framework classes via PyObjC bindings

macOS 10.11 or later required; this package is macOS-only and will not install on other operating systems.

Verify before relying:

- Whether ContactsUI framework functionality is fully exposed or if some APIs remain undocumented in the wrapper layer.
- Performance characteristics when working with large contact databases through the picker interface.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: medium
- Maintenance: active
- Downloads: 657.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

macos contacts ui framework python, contact picker cocoa bindings, pyobjc contactsui wrapper, macos contact selection dialog, objective-c contacts framework python, macos-only, framework-binding, ui-integration

[View on SkillFed](https://skillfed.io/packages/pyobjc-framework-contactsui) · [View on PyPI](https://pypi.org/project/pyobjc-framework-contactsui/)