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

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

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

## What it is and what it does

This package is a thin Python wrapper around macOS's native UserNotifications framework, part of the larger PyObjC project. It translates Objective-C interfaces into Python, allowing developers to programmatically schedule, configure, and deliver system notifications on macOS from Python code. The wrapper does not include its own documentation; instead, it defers to Apple's UserNotifications documentation and PyObjC's general translation guide.

The package is macOS-only and requires pyobjc-core and pyobjc-framework-Cocoa as runtime dependencies. It supports Python 3.10 through 3.15, including free-threading variants. Installation involves downloading pre-built wheels for your specific Python version and macOS architecture. Because it is a direct binding to a native framework, there is no platform abstraction—code written against it will only run on macOS.

Use it for:

- Send system notifications from a Python daemon or background service running on macOS.
- Build a macOS desktop application that needs to alert users with native notification UI.
- Integrate notification delivery into a cross-platform Python app's macOS-specific code path.
- Programmatically schedule notifications with custom payloads and user interaction handlers.

## Worth the install?

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

Provides Python bindings to macOS's UserNotifications framework, enabling programmatic creation and delivery of system notifications on macOS.

Yes, if you are building or maintaining a macOS-specific Python application that needs to send system notifications. The package is actively maintained, carries no known vulnerabilities, and has a permissive license. The main constraint is that it only works on macOS and requires Python 3.10+; if your project targets other platforms or older Python versions, it is not suitable.

## Install

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

## Installing pyobjc-framework-UserNotifications

Before you install: Medium install friction due to platform-specific wheels (macOS only) and compiled dependencies on pyobjc-core and pyobjc-framework-Cocoa. Active maintenance with recent releases (3 days old) and steady repository activity.

License in practice: MIT license permits unrestricted use, modification, and distribution with minimal obligations—suitable for commercial and open-source projects.

Quickstart:

pip install pyobjc-framework-usernotifications

from UserNotifications import UNUserNotificationCenter
center = UNUserNotificationCenter.currentNotificationCenter()

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

Verify before relying:

- Whether the wrapper covers the full UserNotifications API surface or only a subset.
- Specific macOS version requirements beyond the framework's availability.
- Whether async/await patterns are supported for notification handling.

## Package facts

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

## Tags

macos system notifications python, usernotifications framework wrapper, pyobjc notification delivery, macos notification api python, send system alerts macos, cocoa notifications bindings, macos-only, objc-binding, notifications

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