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

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

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

## What it is and what it does

This package wraps Apple's native Contacts framework for macOS, allowing Python code to read, create, and modify contact records directly from the system address book. It depends on pyobjc-core and pyobjc-framework-Cocoa to translate between Python and native macOS APIs.

The package is production-stable and actively maintained, with wheels built for Python 3.10 through 3.15 on macOS 10.9 and later (with newer Python versions requiring macOS 10.13 or 10.15). It does not include its own documentation; users must refer to Apple's Contacts framework documentation and PyObjC's general translation guides to understand how to use the framework.

Use it for:

- Automate contact creation or bulk operations on the macOS address book from a Python script.
- Query and export contact data from the system for reporting or backup purposes.
- Build a macOS desktop application that integrates with the system Contacts app.
- Sync contact information between an external service and the local macOS Contacts database.

## Worth the install?

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

Provides Python bindings to macOS's Contacts framework, enabling programmatic access to contact data and management through native Objective-C APIs.

Yes, if you are developing on macOS and need programmatic access to the system Contacts framework. The package is actively maintained, has no known vulnerabilities, and offers a permissive MIT license. Install friction is moderate due to macOS-only wheels and compiled dependencies, but this is unavoidable for native framework bindings. Not applicable on non-macOS platforms.

## Install

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

## Installing pyobjc-framework-Contacts

Before you install: Medium install friction due to macOS-only wheels and compiled dependencies (pyobjc-core, pyobjc-framework-Cocoa). Active maintenance with a release 3 days old and recent commits; supports Python 3.10–3.15.

License in practice: MIT license is permissive; you may use, modify, and distribute this package freely in commercial or private projects with minimal restrictions.

Quickstart:

pip install pyobjc-framework-contacts

from Contacts import CNContactStore
store = CNContactStore()

macOS only; requires Python 3.10 or later and a Mac with the Contacts framework available.

Verify before relying:

- Whether the Contacts framework is available on all supported macOS versions or has version-specific limitations.
- Performance characteristics when working with large contact databases.
- Whether free-threaded Python wheels have full parity with GIL-bound versions.

## Package facts

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

## Tags

macos contacts framework python, access contacts on mac, pyobjc contacts wrapper, read write contacts macos, objective-c contacts bindings, macos-native, objective-c-bindings

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