Connect Notion

The notion-connect addon links Notion pages, data sources, blocks and views to your arka-deck projects. The agent can read and write in Notion without you leaving the chat.

What arka-deck records — and what it does not

Data	Storage
Connection (token, scopes)	Encrypted in local SQLite (AES-256-GCM)
External references (page id, source id)	Local
Freshness information	Local
Execution log	Local

The addon does not import the whole Notion workspace as a local document base. Only references and explicit operations are recorded.

Configure the connector

Open the project’s External Sources or Notion Config view.
Choose authentication:
- Integration token (create an internal Notion integration and paste its token).
- Notion OAuth (guided flow from the application).
Test the connection.

The token is encrypted locally and is never exposed to the UI after input.

Available actions

Action	Description
Test connection	Check the token works
Search	Find pages, sources, views by title
Read page	Fetch a Notion page and its blocks
Read source	Fetch items from a data source
Read view	Fetch a view (table, kanban, etc.)
Create / update page	Create or modify a page
Append blocks	Add blocks to an existing page
Trash page	Move a page to trash (non-destructive)

The agent can invoke these actions during a turn (with your consent for write operations, depending on your provider permission configuration).

OAuth security

The OAuth state is in-memory, single-use, with a 10-minute TTL.
A restart during authorization invalidates the callback: you must restart the flow.
Encrypted credentials live in <arkaHome>/providers/providers.db.

Boundaries

The connector handles only one connection per project (multi-account planned later).
No automatic background sync of the Notion workspace.
No incoming webhook — arka-deck pulls on demand, no Notion → arka-deck push.

Going further

Notion Connect dev sheet: ../../dev/addons-firstparty/notion-connect
Security posture: 07-securite-et-donnees