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

# Notion

> Connect Notion to Tess to find pages, databases, and knowledge from chat and agents.

The **Notion** connector integrates Tess with Notion. Once connected, the AI can search pages and databases, summarize knowledge, and support documentation workflows inside chats and agents.

Notion is part of the Tess [Connectors](/en/connectors) ecosystem and uses **OAuth** authentication for Apps connectors.

## Prerequisites

<Info>
  * A Notion account with access to the pages/databases you need.
  * Permission to authorize the Notion integration for those workspaces.
</Info>

## How to connect

<Tip>
  On some Apps connectors, the OAuth consent screen may show a third-party connection bridge name rather than Tess. That is normal—review the requested permissions and continue if they match what you expect.
</Tip>

<Steps>
  <Step title="Open the Connectors panel">
    In chat, click the **+** next to the message box and select **Connectors**.
    You can also manage connectors while editing an agent in Agent Studio.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/tess-dfe1edf0/images/connectors/notion/01-connect-panel.png" alt="PRINT: (Connectors panel with Notion highlighted and the Connect button visible)" />
    </Frame>
  </Step>

  <Step title="Find Notion and click Connect">
    Under **Apps**, locate **Notion** and click **Connect** to start authentication.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/tess-dfe1edf0/images/connectors/notion/02-oauth-consent.png" alt="PRINT: (Provider authorization / consent screen for Notion)" />
    </Frame>
  </Step>

  <Step title="Authorize access">
    Sign in with the account you want to use and review the requested permissions before confirming.
  </Step>

  <Step title="Confirm it is active">
    Back in Tess, **Notion** should appear under **Connected**, ready for chats and agents.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/tess-dfe1edf0/images/connectors/notion/03-connected.png" alt="PRINT: (Tess callback or Connectors list showing Notion as Connected with a success state)" />
    </Frame>
  </Step>
</Steps>

## What you can do

* **Search pages and databases** across shared Notion content
* **Summarize docs and wikis** into actionable briefs
* **Create or update pages** when write access is available
* **Support knowledge routines** for product, ops, and support teams
* **Keep internal documentation usable inside Tess**

## Example prompts

> 1. Find the onboarding runbook in Notion and summarize the first-week checklist.
> 2. What changed recently in the Product Specs database?
> 3. Create a meeting notes page for today's sync with action items.
> 4. Pull the FAQs about billing and rewrite them as a short internal brief.

## Best practices

* Share page/database names that are distinctive.
* Ask before creating pages in shared spaces.
* In agents, define whether Notion is for retrieval, summarization, or writing.

## Troubleshooting

<AccordionGroup>
  <Accordion icon="circle-question" title="Pages missing after connect">
    In Notion, confirm the integration was granted access to the relevant pages/databases.
  </Accordion>

  <Accordion icon="circle-question" title="401 / connection dropped">
    Reconnect Notion in Connectors and re-select the pages the integration can access.
  </Accordion>

  <Accordion icon="circle-question" title="Cannot edit a page">
    The connected account or integration share may be read-only.
  </Accordion>
</AccordionGroup>

<Note>
  Tess uses the permissions of the connected account. It does not expand access beyond what that account can already do.

  Connectors involve access to external systems. Only connect accounts that fit the usage context, and review permissions carefully.
</Note>