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

# Notion

> Connect Notion to CloudThinker to search pages and databases, keep documentation current, and confirm every content change

Connect your Notion workspace to let CloudThinker agents search pages and databases, explore structured information, update content, add comments, and organize documentation.

Notion authenticates with an **internal integration token** you create in your Notion workspace. Every content change agents make happens only after you confirm it.

## Prerequisites

* A **Notion account** with permission to create integrations in the workspace.
* The pages and databases you want agents to reach, connected to that integration.

## Setup

<Steps>
  <Step title="Create a Notion integration">
    Go to [notion.so/profile/integrations](https://www.notion.so/profile/integrations) and create a new **internal** integration for your workspace. Copy the integration token it generates.
  </Step>

  <Step title="Give the integration access to content">
    In the integration's settings, open the **Access** tab and connect the pages and databases agents should reach. You can also connect an individual page from its **•••** menu with **Connect to integration**.
  </Step>

  <Step title="Add the connection in CloudThinker">
    Navigate to **Connections → Notion** and paste the token into **NOTION\_TOKEN**.

    Click **Connect**. CloudThinker verifies the credential and shows a **Connected** status.
  </Step>
</Steps>

## Connection details

| Field             | Description                                                      | Example |
| ----------------- | ---------------------------------------------------------------- | ------- |
| **NOTION\_TOKEN** | Internal integration token from your Notion integration settings | —       |

## Required permissions

The integration's **Capabilities** settings in Notion decide what agents can do. Grant only what your workflow needs:

* **Read content** is enough for search and summarization.
* Add **Update content** and **Insert content** only if you want agents to edit or create pages — each change still waits for your confirmation in CloudThinker.

<Tip>
  Start with a read-only integration — only **Read content** enabled — and connect only the pages agents genuinely need. Widen later if a workflow requires it.
</Tip>

## Agent capabilities

Once connected, agents can:

| Capability               | Description                                                          |
| ------------------------ | -------------------------------------------------------------------- |
| **Search**               | Search connected pages and databases for answers                     |
| **Structured data**      | Explore database rows and properties                                 |
| **Content updates**      | Update pages and insert content — only after you confirm each change |
| **Comments**             | Add comments to pages for the team                                   |
| **Documentation upkeep** | Organize documentation and flag stale content                        |

### Verify the connection

```text theme={null}
@anna search my Notion workspace for the onboarding runbook and summarize it
```

### Example prompts

```text theme={null}
@anna #report a summary of the incident postmortems database in Notion for the last quarter
@anna #report which Notion pages about deployment procedures have not been updated in 6 months
@anna draft an update to the on-call handbook page in Notion with the new escalation contacts
```

## Troubleshooting

<Accordion title="401 Unauthorized">
  The token is wrong or was revoked. Copy the current token from your integration's settings and update the connection.
</Accordion>

<Accordion title="Agent cannot find a page that exists">
  The page is not connected to the integration. Open the integration's **Access** tab and add the page, or connect it from the page's **•••** menu.
</Accordion>

<Accordion title="Content changes fail">
  The integration lacks the **Update content** or **Insert content** capability. Enable it in the integration's **Capabilities** settings in Notion, or keep the connection read-only on purpose.
</Accordion>

## Security

* **Least privilege** — grant only the permissions the agents need for your use case; start read-only and widen later.
* **Read-only by default** — use read-only credentials unless you want agents to make changes through this connection.
* **Rotate credentials** — rotate keys and tokens on your normal schedule; CloudThinker picks up the new value when you update the connection.
* **Revoke on offboarding** — remove the credential at the provider when you delete a connection or a teammate leaves.

- **Connect pages deliberately** — the integration only sees pages you connect to it, so the Access list is your scope control.
- **Confirmation for edits** — agents change Notion content only after you confirm the change.

## Related

<CardGroup cols={2}>
  <Card title="Knowledge Base" icon="book" href="/guide/knowledge">
    Give agents searchable workspace knowledge inside CloudThinker
  </Card>

  <Card title="Atlassian Connection" icon="https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/atlassian.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=64fcf0381646a233832602a9086a14eb" href="/guide/connections/atlassian" width="24" height="24" data-path="images/icons/atlassian.svg">
    Jira and Confluence for issues and docs
  </Card>
</CardGroup>