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

# Notion AI integration

> Extend the Omni Agent with the ability to search and retrieve content from your Notion workspace.

export const integration_0 = "Notion"

Omni's Notion AI integration extends the Omni Agent with the ability to search and retrieve content from your Notion workspace. This allows you to reference documentation, project plans, and knowledge base articles alongside your data analysis workflows. Using the Notion integration, you could:

* **Reference project documentation** - Pull context from project specs or requirements while analyzing related data in Omni
* **Access knowledge base articles** - Retrieve documented processes or definitions to inform your analysis
* **Review team notes** - Reference meeting notes or decisions documented in Notion while working with data

For example, you could ask: *"Find our data dictionary in Notion and then show me the user engagement metrics"* - combining documentation with data analysis in a single conversation.

## Common questions

<AccordionGroup>
  <Accordion title="What can the Omni Agent access?">
    Every Omni user that wants to use the Notion AI integration must connect their Notion account. This means that the Omni Agent will have the same permissions as the prompting user, accessing only the pages and databases they have access to.
  </Accordion>

  <Accordion title="How are Notion pages and content processed?">
    Notion content is processed the same way as other AI features in Omni. Refer to [AI data privacy](/ai/security) for more information.
  </Accordion>
</AccordionGroup>

## Setting up the Notion integration

<Note>
  **Organization Admin** permissions are required to configure the Notion integration.
</Note>

<Steps>
  <Step noAnchor>
    In Omni, navigate to **Settings > Integrations**.
  </Step>

  <Step noAnchor>
    Click the **AI Integrations** tab.
  </Step>

  <Step noAnchor>
    Toggle the **Notion integration** to **on**.
  </Step>
</Steps>

The integration will be available in your Omni organization. Each user must connect their individual accounts in their [user settings](/administration/users/your-account) to use the integration.

<h2 id="connect-user-account">
  Connecting your Notion account
</h2>

<Note>
  **This section applies to all users**, not only {integration_0} admins. Every user who wants to use the {integration_0} AI integration must connect their {integration_0} account.
</Note>

After the {integration_0} AI integration is enabled for your Omni organization, users will need to connect their individual {integration_0} accounts to use the integration:

<Steps>
  <Step noAnchor>
    In Omni, click your user icon and then [**Manage account**](/administration/users/your-account).
  </Step>

  <Step noAnchor>
    Scroll down to the **Connected Services** section.
  </Step>

  <Step noAnchor>
    Next to the **{integration_0}** integration, click **Connect**.
  </Step>

  <Step noAnchor>
    Complete the authentication flow to connect your account.
  </Step>
</Steps>

## Using Notion in the Omni Agent

<Note>
  Before users can use Notion with the Omni Agent, they will need to connect their Notion accounts in their [user settings](/administration/users/your-account).
</Note>

Once your Notion account is connected, you can ask the Omni Agent to search for pages or retrieve content from your Notion workspace.

### Searching pages

The Omni Agent can search across all pages and databases you have access to in Notion. To search for content, ask questions like:

* "Search my Notion workspace for the project roadmap"
* "Find documentation about our data pipeline in Notion"
* "Look for meeting notes from last quarter in Notion"

### Retrieving content

You can also ask the Omni Agent to retrieve specific pages or content from your Notion workspace:

* "Show me the contents of our data dictionary page in Notion"
* "Get the project requirements from Notion"
* "Fetch the onboarding guide from our Notion workspace"

The Agent returns the page content inline, so you can review documentation and notes without leaving Omni.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Failed to connect Notion error">
    This error can occur if:

    * The OAuth authorization was cancelled or interrupted
    * Your Notion session has expired
    * Network connectivity issues occurred during the connection process

    Try connecting again from your [user settings](/administration/users/your-account).
  </Accordion>

  <Accordion title="Notion tools not appearing in the Omni Agent">
    Tools will only become accessible after an individual user connects their Notion account in their user settings. Verify that the user has [connected their Notion account](#connect-user-account).
  </Accordion>

  <Accordion title="Cannot find specific pages">
    If you can't find specific pages:

    * Verify you have access to the page in Notion
    * Check that the page is not in a private workspace you don't have access to
    * Ensure the page has been shared with you in Notion
  </Accordion>
</AccordionGroup>

## Next steps

* [Explore the Omni Agent](/ai/chat) to learn more about conversational data analysis
* [Optimize your models for AI](/modeling/develop/ai-optimization) to improve AI-generated query quality
* [Connect other AI integrations](/integrations/ai) to add external context
* [Review AI security practices](/ai/security) to understand how Omni processes data