--- title: Notion summary: Connect a Notion workspace so your AI agents can search, read, create, and update pages and databases under permissions you control. category: integrations slug: notion --- ## What Notion in Kronos lets your agents do Once a Notion workspace is connected to Kronos, your agents can — within the permissions you grant — work with the pages and databases the workspace has shared with the connection: **Read actions** (available when an agent has "Read only" or higher): - Search pages and databases across the connected workspace. - Open a specific page and read its content blocks. - Read a block's metadata or list the blocks nested inside it. - Fetch a database, query its rows, and read a single row. - Read a page's properties and a database's property definitions. - Read comments on a page or a specific comment. - List the people and bots in the workspace, and read the connected workspace's own profile. **Write actions** (available only when an agent has "Read and write"): - Create a new page or duplicate an existing one. - Add content to a page (single or multiple blocks at once). - Append nested blocks for full structural control. - Update a page, update a block, or delete a block. - Archive a page (move it to trash) or restore it. - Create a database and update its schema. - Insert, update, and read rows in a database. - Add a comment to a page. You decide which agent gets which level, and you can switch any permission off in one click without disconnecting the Notion workspace. ## Connecting Notion 1. Open Kronos → **Connect** in the sidebar → **Applications** tab. 2. Click the **Notion** card to open the detail dialog, then click the green **Connect** button. 3. You land on Notion's authorization screen. Sign in if you aren't already, and pick the workspace you want to connect. 4. Choose which pages and databases the connection can access. Notion only lets agents see the pages you select here, so include the ones your agents will need to work with. 5. Approve the access. You're sent back to Kronos at the **Already connected** tab with the new Notion entry pre-selected. You can connect more than one Notion workspace; each appears as its own connection with its own workspace name. ## Telling connections apart The Notion management page shows the connected workspace's name right under the "Notion" title (for example, `Acme HQ`). This is how Kronos and you identify which workspace this connection represents. If you connect more than one workspace, each appears with its own workspace name. Optionally you can add a short personal note next to it (the "Your note for this connection" field) — labels like "Team Wiki", "Personal", or "Client Docs" make it easier to scan a long list. The note is yours only; agents always identify the workspace by its name and ID, not by the note. ## Giving an agent access On the Notion management page click **+ Add AI Agent**, pick the agent from the dropdown, then choose: - **Off** — the agent cannot touch this Notion workspace. - **Read only** — the agent can search, read pages, and query databases, but cannot create, update, archive, or comment. - **Read and write** — the agent can do all of the above plus create and update pages, edit blocks, manage databases, and comment. The same controls are available inside the AI Agent editor — scroll to the **Connected Apps** section. ## Fine-grained overrides Inside the permissions modal (the gear icon next to a Notion workspace in the agent editor or on the management page) you'll see the full list of Notion actions grouped by **Read tools** and **Write tools**. Toggle individual actions on or off to override the preset. Common combinations: - **Research-only agent**: preset Read only, no overrides. The agent searches the workspace and summarizes pages but cannot change anything. - **Note-taker agent**: preset Read only, override `Add content to Notion page` ON. The agent can read pages and append notes, but cannot delete blocks or archive pages. - **Safe editor agent**: preset Read and write, override `Archive Notion page` OFF and `Delete a block` OFF. The agent can create and edit, but cannot remove pages or blocks. - **Full assistant**: preset Read and write, no overrides. Click Save to apply. Changes take effect on the next message the agent processes. ## Multiple Notion workspaces on the same agent If an agent has access to two or more Notion workspaces (e.g. Team Wiki + Client Docs), the agent picks which workspace to use on every action based on context. When the request is ambiguous ("add a page about the launch"), the agent will ask which workspace to use. You can cut ambiguity by turning the agent's access to one workspace off, or by giving the connections obviously distinct notes ("Team Wiki" vs "Client Docs"). ## When something goes wrong - **"Needs reconnect"** badge — Notion revoked or expired the connection. Open `/app/connect`, click Notion, walk through Connect again. Permissions are preserved. - **Agent says "I can't find that page"** — the page wasn't shared with the connection. In Notion, share the page (or its parent) with the Kronos connection, or re-run Connect and widen the selected pages. - **Agent says "I can't update that page"** — that agent's permission preset is Off or Read only without the matching write override. Open the permissions modal and adjust. - **Agent says the connected app is temporarily unavailable** — Notion or the connection had a transient hiccup. Ask the user to retry in a moment. If it persists, check the management page for a "Needs reconnect" badge. ## Privacy Kronos does NOT store the content of your Notion pages. Each time an agent uses a Notion action, it fetches just-in-time from Notion through the connection, uses what it needs to complete the task, and discards the result. The audit log records that the action happened (which agent, which action, when, and whether it succeeded), but not the page content. When you disconnect Notion or cancel your Kronos subscription, the connection and all per-agent permissions are deleted immediately.