Notion Integration — Connect Your Project Tracking to Focus Engine
Notion Integration — Connect Your Project Tracking to Focus Engine
Version: 0.1.12
Focus Engine now connects to Notion via OAuth, bringing your Notion tasks and database items into the same unified view as your GitHub issues, calendar, and email — so nothing important is left behind in a tab you forgot to check.
Why Notion?
Many technical teams use Notion as their primary project tracker: sprint boards, task databases, roadmap tables, and personal to-do pages all live there. But until now, those tasks existed outside Focus Engine's awareness. Your GitHub issues were prioritised. Your Notion tasks were not. That gap is now closed.
What Gets Pulled In
Once connected, Focus Engine fetches Notion database items that meet both of the following criteria:
- Assigned to you — items where you are listed as the assignee.
- Actionable fields present — items that have a due date field, a status field, or both.
This filter ensures only real, trackable work enters your daily briefing — not every page or note in your workspace.
Unified Task Model
Notion items are mapped to Focus Engine's unified task model, the same internal representation used for tasks from GitHub, Linear, Asana, and Todoist. This means your Notion tasks:
- Appear in the Daily Briefing — alongside tasks from every other connected source.
- Are included in prioritisation — due dates and status are factored into smart focus recommendations.
- Can be scheduled by the Day Planner — Notion tasks are eligible for calendar focus blocks, just like any other task.
- Participate in deduplication — if the same work appears in Notion and another system, Focus Engine recognises the overlap and surfaces it once.
Connecting Notion
- Go to Settings → Integrations.
- Select Notion.
- Click Connect and complete the OAuth authorisation flow.
- Grant access to the databases and pages you want Focus Engine to read.
- Your Notion tasks will appear in your next Daily Briefing.
The integration uses OAuth, so Focus Engine never stores your Notion credentials. You can revoke access at any time from within Notion's Settings → My connections page.
Notes & Limitations
- Only items assigned to you are fetched. Shared pages without an assignee field are not included.
- Database items without a due date or status field are excluded to avoid noise.
- The Notion integration is fully optional. If you do not connect it, all other integrations and features continue to work as normal.
What's Next
Notion integration is the foundation for richer project-level context. Future work may include sub-task support, project-level status roll-ups, and bi-directional status updates (marking tasks complete from within Focus Engine).