> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vis42.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Notion

> Connect your Notion workspace so VIS42 agents can read and write pages and databases.

Connect your Notion workspace to let VIS42 agents work directly with your documents. Your agents can capture meeting notes, log audit findings, publish financial snapshots, and query databases — all from the same conversation.

## What your agents can do

Once connected, VIS42 agents have five Notion capabilities:

* **Search** your workspace for pages and databases by title
* **Read** a page's content as markdown
* **Query** a database with filters (and see row properties summarized)
* **Create** a new page under a parent page or as a database row
* **Append** content to an existing page without replacing what's there

Which agent uses which capability depends on what you ask. For example:

* Ask **Mercury** to *"save these meeting notes to Notion"* and it will create a page.
* Ask **Themis** to *"compare last month's P\&L to the budget in Notion"* and it will query your budget database.
* Ask **Pluto** to *"log this audit finding in my compliance tracker"* and it will append a row.

## Connect your workspace

<Steps>
  <Step title="Open agent settings">
    Open any agent (Mercury, Themis, or Pluto) and scroll to the **Connected Services** section.
  </Step>

  <Step title="Click Connect on the Notion card">
    You'll be redirected to Notion's consent screen.
  </Step>

  <Step title="Pick the pages to share">
    Notion asks which pages or databases you want VIS42 to access. **This step matters** — VIS42 can only read or write pages you select here (or share with it later). See [Sharing pages](#sharing-pages) below.
  </Step>

  <Step title="Authorize">
    Click **Allow access**. You'll be sent back to VIS42 with the integration marked as **Enabled**.
  </Step>
</Steps>

## Sharing pages

<Warning>
  **Notion integrations only see pages you explicitly share with them.** Connecting through OAuth gives VIS42 an identity in your workspace — it does **not** grant access to any content by default.
</Warning>

### How access works

* **During OAuth:** Notion shows a page-picker. Anything you select is shared with VIS42.
* **After OAuth:** On any page or database → click the **`···`** menu → **Connections** → add **VIS42**.
* **Inheritance:** access cascades automatically to all sub-pages. Share a parent page once and every page under it becomes available.

### Recommended setup

Create a single parent page — for example **VIS42 Workspace** or **AI Workspace** — and share it with the integration. Then keep everything the agents need underneath:

```
📄 VIS42 Workspace      ← share this one page
  ├─ 📄 Meeting notes
  ├─ 📊 Budget tracker (database)
  ├─ 📄 Audit log
  └─ 📄 Financial snapshots
```

Every new page you create under **VIS42 Workspace** is automatically visible to your agents. Nothing else in your Notion is exposed.

<Tip>
  If you create a page at the workspace root (not under a shared parent), VIS42 cannot see it until you share it explicitly. Put it under the shared parent instead.
</Tip>

## Privacy and scope

* The connection is **per user, per business** — each team member connects their own Notion workspace.
* VIS42 stores an access token tied to your Notion account. Tokens are encrypted at rest.
* VIS42 can only access pages shared with the integration — nothing else in your workspace.
* Disconnect at any time from **Connected Services** in the agent settings page. Your token is invalidated and removed from VIS42.

## Markdown content

When agents create or append content, they pass lightweight markdown that VIS42 converts into Notion blocks:

| Markdown     | Notion block       |
| ------------ | ------------------ |
| `# Title`    | Heading 1          |
| `## Title`   | Heading 2          |
| `### Title`  | Heading 3          |
| `- Item`     | Bulleted list item |
| `- [ ] Task` | Unchecked to-do    |
| `- [x] Done` | Checked to-do      |
| Plain text   | Paragraph          |

Nested lists, toggles, and code blocks are not supported in this release — paragraphs, headings, bullets, and to-dos cover the common cases.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Agent says it can't find a page I just created">
    The page is probably not shared with VIS42. Either move it under a shared parent, or open the page → **`···`** → **Connections** → add **VIS42**.
  </Accordion>

  <Accordion title="I connected Notion but no pages appear">
    You didn't select any pages during the OAuth consent step. Either:

    * Disconnect and reconnect, then pick pages in the consent dialog, or
    * Open any page you want to expose → **`···`** → **Connections** → add **VIS42**.
  </Accordion>

  <Accordion title="Agent can read pages but can't create or update them">
    The integration is missing write capabilities. Disconnect and reconnect — the consent screen will request the required permissions again. If you manage the integration yourself, make sure **Update content** and **Insert content** are enabled.
  </Accordion>

  <Accordion title="I want to revoke access from Notion's side">
    In Notion, go to **Settings** → **Connections** → find **VIS42** → **Disconnect**. This revokes the token immediately. You'll also want to disconnect from VIS42's agent settings to clean up the local record.
  </Accordion>
</AccordionGroup>