pyobjc-framework-Contacts
Wrappers for the framework Contacts on macOS
Decision gist · record as of 2026-08-14
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.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- macOS only; requires Python 3.10 or later and a Mac with the Contacts framework available.
- 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 · maintenance · safety
MIT (permissive) — MIT license is permissive; you may use, modify, and distribute this package freely in commercial or private projects with minimal restrictions.
last release 2026-08-11 (3 days) · last repo commit 2026-08-14 · 803 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 692,107 downloads/mo, #5,323 on PyPI
Alternatives
Verify before relying
pip install pyobjc-framework-contacts
from Contacts import CNContactStore
store = CNContactStore()- 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.
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 on this page. Verify before relying on it.
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
pyobjc-framework-contacts on PyPI
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.
macOS only; requires Python 3.10 or later and a Mac with the Contacts framework available.
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()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 the current Python release >=3.10 |
| Install friction | Medium. Platform-specific wheel |
| Runtime dependencies | 2 packagespyobjc-corepyobjc-framework-Cocoa |
| Maintenance | Actively maintained 3 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 692,107 / month, #5,323 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableEnvironment :: ConsoleEnvironment :: MacOS X :: CocoaIntended Audience :: DevelopersNatural Language :: EnglishOperating System :: MacOS :: MacOS XProgramming Language :: Objective CProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: 3.15Programming Language :: Python :: Free Threading :: 3 - StableProgramming Language :: Python :: Implementation :: CPythonTopic :: Software Development :: Libraries :: Python ModulesTopic :: Software Development :: User Interfaces |
Evidence: pyobjc_framework_contacts-12.2.2-cp310-cp310-macosx_10_9_universal2.whl; pyobjc_framework_contacts-12.2.2-cp311-cp311-macosx_10_9_universal2.whl; pyobjc_framework_contacts-12.2.2-cp312-cp312-macosx_10_13_universal2.whl; pyobjc_framework_contacts-12.2.2-cp313-cp313-macosx_10_13_universal2.whl; pyobjc_framework_contacts-12.2.2-cp313-cp313t-macosx_10_13_universal2.whl; pyobjc_framework_contacts-12.2.2-cp314-cp314-macosx_10_15_universal2.whl; pyobjc_framework_contacts-12.2.2-cp314-cp314t-macosx_10_15_universal2.whl; pyobjc_framework_contacts-12.2.2-cp315-cp315-macosx_10_15_universal2.whl; pyobjc_framework_contacts-12.2.2-cp315-cp315t-macosx_10_15_universal2.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “macos contacts framework python”
- pyobjc-framework-ContactsProvides Python bindings to macOS's Contacts framework, enabling…
- pyobjc-framework-ContactsUIProvides Python bindings to macOS's ContactsUI framework, enabling…
- pyobjc-framework-AddressBookProvides Python bindings to macOS's AddressBook framework, allowing…
Give your agent the search over MCP, or paste the wish link into any chat.
More Python Modules packages
Converts domain names between Unicode and ASCII-compatible encoding (Punycode) according to IDNA 2008 and Unicode Technical Standard 46, with security validation and broader script coverage than the standard library.
Install it if you work with internationalized domain names, need to validate domains, or use HTTP clients that depend on it transitively.
Setuptools is a Python build backend and package management tool that handles building, distributing, and installing Python packages, including support for C/C++ extension modules.
PyYAML parses and emits YAML 1.1 data format, enabling serialization and deserialization of configuration files and Python objects to and from human-readable YAML text.
Pydantic validates Python data structures against type hints, coercing and checking input at runtime to ensure it matches a declared schema.
Provides reusable metadata objects for use with PEP-593 `typing.Annotated` to express common constraints like bounds, collection sizes, and predicates on types.
Install it if you use or build libraries that need to express type constraints in a standardized, inspectable way—or if you want to annotate your own types with…
Provides runtime tools to inspect and introspect Python type annotations, enabling programmatic examination of type hints at execution time.
See also pyobjc-framework-AddressBook · pyobjc-framework-ContactsUI · pyobjc-framework-InputMethodKit · pyobjc-framework-Network · pyobjc-framework-CallKit · pyobjc-framework-Cocoa · pyobjc-framework-Accounts · pyobjc-framework-BusinessChat · pyobjc-framework-SafariServices · pyobjc-framework-ThreadNetwork