aionotion
A simple Python 3 library for Notion Home Monitoring
Decision gist · record as of 2026-08-14
Yes, with caution about maintenance. The package is well-designed for asyncio workflows and has no known vulnerabilities, but dormancy (556 days since last release) and lack of visible repository activity raise questions about whether it will track future Notion API changes. Install if you need async Notion sensor integration now and can tolerate potential staleness; monitor the repository for signs of abandonment.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.11 or later; aiohttp ClientSession must be created and passed to the client factory.
- Low install friction with a pure-Python wheel.
- Maintenance is dormant (556 days since last release), though the package was released recently (2025-02-04) and supports current Python versions (3.11–3.13).
License · maintenance · safety
MIT (permissive) — Licensed under MIT, a permissive license that allows use, modification, and distribution with minimal restrictions.
last release 2025-02-04 (556 days)
0 known vulnerabilities (OSV.dev, 2026-08-14) · 74,601 downloads/mo, #14,811 on PyPI
Alternatives
Verify before relying
pip install aionotion
import asyncio
from aiohttp import ClientSession
from aionotion import async_get_client_with_credentials
async def main():
async with ClientSession() as session:
client = await async_get_client_with_credentials(
username, password, session=session
)
sensors = await client.sensor.async_all()
asyncio.run(main())- Whether the 556-day dormancy period indicates the package is actively maintained or abandoned despite the recent 2025-02-04 release.
- Whether Notion's home monitoring API remains stable and whether this library continues to work with current Notion service changes.
What it is and what it does
aionotion wraps the Notion home monitoring API in an asyncio-friendly Python interface. It lets you authenticate with Notion credentials or a refresh token, then query your account's systems (households), bridges, sensors, and listener definitions asynchronously. The library handles token refresh automatically and supports connection pooling via aiohttp ClientSession for efficient bulk operations.
The package is built on aiohttp, PyJWT, mashumaro, and ciso8601, providing async/await syntax throughout. It's designed for Python 3.11+ and supports both CPython and PyPy. Common workflows include fetching all sensors, retrieving a specific sensor by ID, querying listener definitions, and managing refresh token callbacks for persistent authentication.
Use it for
- Fetch all home sensors and their current state in an async application monitoring a Notion-equipped home.
- Build a dashboard that polls Notion systems and bridges periodically without blocking other async tasks.
- Integrate Notion sensor data into a home automation framework that requires async/await patterns.
- Persist refresh tokens and re-authenticate using stored credentials across application restarts.
- Query listener definitions to understand what conditions Notion sensors can monitor.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, with caution about maintenance.
The package is well-designed for asyncio workflows and has no known vulnerabilities, but dormancy (556 days since last release) and lack of visible repository activity raise questions about whether it will track future Notion API changes. Install if you need async Notion sensor integration now and can tolerate potential staleness; monitor the repository for signs of abandonment.
Install
aionotion on PyPI
Before you install
Low install friction with a pure-Python wheel. Maintenance is dormant (556 days since last release), though the package was released recently (2025-02-04) and supports current Python versions (3.11–3.13).
Requires Python 3.11 or later; aiohttp ClientSession must be created and passed to the client factory.
License in practice
Licensed under MIT, a permissive license that allows use, modification, and distribution with minimal restrictions.
Quickstart
pip install aionotion
import asyncio
from aiohttp import ClientSession
from aionotion import async_get_client_with_credentials
async def main():
async with ClientSession() as session:
client = await async_get_client_with_credentials(
username, password, session=session
)
sensors = await client.sensor.async_all()
asyncio.run(main())Verify before relying
- Whether the 556-day dormancy period indicates the package is actively maintained or abandoned despite the recent 2025-02-04 release.
- Whether Notion's home monitoring API remains stable and whether this library continues to work with current Notion service changes.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release <3.14,>=3.11 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 7 packagesPyJWTaiohttpcertificiso8601frozenlistmashumaroyarl |
| Maintenance | Dormant 556 days since the last release |
| First released | |
| Downloads | 74,601 / month, #14,811 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | License :: OSI Approved :: Apache Software LicenseProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: Implementation :: CPythonProgramming Language :: Python :: Implementation :: PyPy |
Evidence: aionotion-2025.2.0-py3-none-any.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 › “notion home monitoring api”
- aionotionaionotion is an asyncio-friendly Python library for interacting with…
- notion-to-md-pyConverts Notion pages to Markdown files via the Notion API,…
- notion-clientA Python client library for the official Notion API that provides…
Give your agent the search over MCP, or paste the wish link into any chat.
More Monitoring packages
Wraps any iterable to display a real-time progress bar in the terminal or Jupyter notebook, showing iteration count, elapsed time, and estimated time remaining.
Provides generated Python code for OpenTelemetry semantic conventions, enabling standardized attribute naming and constant definitions for instrumentation and telemetry collection.
Install it if you are using OpenTelemetry and want to follow semantic conventions correctly.
Provides the reference implementation of the OpenTelemetry API for collecting and exporting traces, metrics, and logs from Python applications.
Provides the abstract API and interfaces for OpenTelemetry instrumentation in Python, defining how to emit traces, metrics, and logs without tying code to a specific SDK implementation.
Exports OpenTelemetry observability data to an OpenTelemetry Collector using Protobuf-encoded messages over HTTP.
Install it if you are using OpenTelemetry in Python and need to send data to a Collector over HTTP.
Provides automatic instrumentation commands and programmatic APIs to inject distributed tracing into Python applications without code changes, detecting and instrumenting packages used by your program.
Install it if you need distributed tracing without code changes and have compatible instrumented packages in your environment.
See also aioambient · aioguardian · aioflo · simplisafe-python · aioairq · aiohue · notion · notion-client · aiorecollect · yalexs