Home Assistant custom integration that surfaces Notion tasks as a Todo list.
- HACS (custom repo): add this repo, then install.
- Manual: copy
custom_components/notion_todointo your HA config.
- Create a Notion internal integration and copy the token.
- Share your task database with that integration.
- Add Notion Todo in Home Assistant and enter:
- Token
- Database ID (or paste the full database URL)
- If the database has multiple data sources, select one when prompted
- Property names (optional)
Default property names:
- Title:
Name - Status:
Status - Due:
Due - Description:
Description
Filtering:
- Include statuses: comma-separated (e.g.
Next) - Exclude statuses: comma-separated (e.g.
Someday, Inbox, Waiting, Dropped) - Include due within days: number of days (e.g.
7)
- Read-only for now (lists tasks only).
- Status mapping: any status containing "done" or "complete" is treated as completed.
- Uses Notion API version 2025年09月03日 to support multi-source databases.