skillfed

pyobjc-framework-AddressBook

Wrappers for the framework AddressBook on macOS

pyobjc-framework-addressbook v12.2.2 664.2K downloads/30d#5,432 on PyPI803
Permissive license MIT Active released

What it is and what it does

This package wraps Apple's AddressBook framework for use in Python, giving you access to the system's centralized contact database on macOS. It lets you read and manipulate contact information programmatically through Python code that calls into the underlying Objective-C framework. The package is part of the larger PyObjC project and depends on pyobjc-core and pyobjc-framework-Cocoa to bridge between Python and Objective-C.

Because it is a thin wrapper around the native framework, it does not include its own documentation—you rely on Apple's AddressBook documentation and PyObjC's general translation guides to understand how to use it. The package is production-stable and actively maintained, with wheels built for Python 3.10 through 3.15 on macOS.

Use it for:

  • Build a macOS application that reads contact information from the system address book
  • Automate contact management tasks by programmatically querying or modifying address book entries
  • Integrate contact data from the address book into a Python workflow or data pipeline on macOS
  • Create a macOS utility that syncs or exports address book contacts to external services

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides Python bindings to macOS's AddressBook framework, allowing programmatic access to the system's centralized contact database from Python code.

Yes, if you are developing on macOS and need programmatic access to the system address book. 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 that is unavoidable for framework bindings. Not applicable on non-macOS systems.

Install

pyobjc-framework-addressbook on PyPI

pip

pip install pyobjc-framework-addressbook

uv

uv add pyobjc-framework-addressbook

poetry

poetry add pyobjc-framework-addressbook

Installing pyobjc-framework-AddressBook

Before you install

Medium install friction due to platform-specific wheels (macOS only, multiple Python versions) and compiled dependencies on pyobjc-core and pyobjc-framework-Cocoa. Actively maintained with recent releases.

License in practice

MIT license permits commercial and private use with minimal restrictions; suitable for most projects.

Quickstart

pip install pyobjc-framework-addressbook
import AddressBook
ab = AddressBook.ABAddressBook.sharedAddressBook()

macOS only; requires Python 3.10 or later and a macOS system with the AddressBook framework available

Verify before relying

  • Whether the AddressBook framework is available on all supported macOS versions listed in the wheel filenames
  • Whether pyobjc-core and pyobjc-framework-Cocoa have their own unresolved security issues or maintenance gaps

Package facts

License MIT (permissive)
Python support supports the current Python release (>=3.10)
Install friction medium — platform-specific wheel
Runtime dependencies 2 — pyobjc-core, pyobjc-framework-Cocoa
Maintenance actively maintained — 3 days since the last release
Last repo commit
First released
Downloads 664,232/month — #5,432 on PyPI (30-day window, as of 2026-08-14)
Known vulnerabilities none known (OSV.dev, checked 2026-08-14)

Evidence: pyobjc_framework_addressbook-12.2.2-cp310-cp310-macosx_10_9_universal2.whl; pyobjc_framework_addressbook-12.2.2-cp311-cp311-macosx_10_9_universal2.whl; pyobjc_framework_addressbook-12.2.2-cp312-cp312-macosx_10_13_universal2.whl; pyobjc_framework_addressbook-12.2.2-cp313-cp313-macosx_10_13_universal2.whl; pyobjc_framework_addressbook-12.2.2-cp313-cp313t-macosx_10_13_universal2.whl; pyobjc_framework_addressbook-12.2.2-cp314-cp314-macosx_10_15_universal2.whl; pyobjc_framework_addressbook-12.2.2-cp314-cp314t-macosx_10_15_universal2.whl; pyobjc_framework_addressbook-12.2.2-cp315-cp315-macosx_10_15_universal2.whl; pyobjc_framework_addressbook-12.2.2-cp315-cp315t-macosx_10_15_universal2.whl

Keywords: PyObjC, AddressBook

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

Tags

macos addressbook python bindingsaccess contacts from pythonpyobjc addressbook wrappermacos contact database pythonaddressbook framework python
macos-onlyframework-bindingscontact-management

More Python Modules packages

idna

Converts domain names between Unicode and…

permissive · top 100 on PyPI

setuptools

Setuptools is a Python build backend and…

permissive · top 100 on PyPI

PyYAML

PyYAML parses and emits YAML 1.1 data format,…

permissive · top 100 on PyPI

pydantic

Pydantic validates Python data structures…

permissive · top 100 on PyPI

annotated-types

Provides reusable metadata objects for use with…

permissive · top 100 on PyPI

typing-inspection

Provides runtime tools to inspect and…

permissive · top 100 on PyPI

pyobjc-framework-Contacts

Provides Python bindings to macOS's Contacts…

permissive · top 15,000 on PyPI

pyobjc-framework-ContactsUI

Provides Python bindings to macOS's ContactsUI…

permissive · top 15,000 on PyPI

pyobjc-framework-Accounts

Provides Python bindings to macOS's Accounts…

permissive · top 15,000 on PyPI

pyobjc-framework-Network

Provides Python bindings to Apple's Network…

permissive · top 15,000 on PyPI

pyobjc-framework-SafariServices

Provides Python bindings to macOS's…

permissive · top 15,000 on PyPI

pyobjc-framework-Carbon

Provides Python bindings to macOS's Carbon…

permissive · top 15,000 on PyPI

pyobjc-framework-FSKit

Provides Python bindings to macOS's FSKit…

permissive · top 15,000 on PyPI

pyobjc-framework-CallKit

Provides Python bindings for Apple's CallKit…

permissive · top 15,000 on PyPI

pyobjc-framework-NotificationCenter

Provides Python bindings to macOS's…

permissive · top 15,000 on PyPI

pyobjc-framework-MapKit

Provides Python bindings to Apple's MapKit…

permissive · top 15,000 on PyPI