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

# Notion Integration

> Configure Notion workspace integration

## Overview

CrewAI supports integration with Notion, enabling your crews to access workspaces, databases, pages, and comments.

## Prerequisites

* A Notion account
* Workspace owner or admin permissions to create integrations
* Access to [Notion Integrations](https://www.notion.so/my-integrations)

## Notion Integration Setup

### Step 1: Create a New Integration

1. Navigate to [Notion Integrations](https://www.notion.so/my-integrations)

2. Click **New integration**

3. Fill in the integration details:
   * **Name**: Enter a name (e.g., "CrewAI")
   * **Logo**: Optional logo for the integration
   * **Associated workspace**: Select the workspace to integrate with

4. Click **Submit**

### Step 2: Configure Capabilities

1. In your integration settings, configure the **Capabilities**:
   * **Content Capabilities**: Select what content the integration can access
   * **Comment Capabilities**: Enable if you need to create comments
   * **User Capabilities**: Enable to read user information

2. Under **OAuth Domain & URIs**:

   * **Redirect URIs**: Add your redirect URI:

     **Default configuration (NGINX with shared hostname):**

     ```
     https://<YOUR_APPLICATION_HOST>/oauthsvc/oauth/add
     ```

     **Separate OAuth hostname (GKE/ALB with `path: "/"`):**

     ```
     https://<YOUR_OAUTH_HOST>/oauth/add
     ```

   See [OAuth Redirect URI Patterns](/features/built-in-integrations-overview#oauth-redirect-uri-patterns) for the correct redirect URI format based on your ingress configuration.

### Step 3: Get Your Credentials

1. In the **Secrets** section, locate:
   * **OAuth client ID**: Your integration's client ID
   * **OAuth client secret**: Click to reveal the secret

2. Store these credentials securely for CrewAI configuration

<Warning>
  Notion uses a different authentication method than typical OAuth. The integration must be explicitly shared with pages and databases in Notion before it can access them.
</Warning>

## Required Scopes

Notion uses capability-based permissions rather than traditional OAuth scopes. The following scopes are used during OAuth:

| Scope             | Description                              |
| ----------------- | ---------------------------------------- |
| `read:user`       | Read user information from the workspace |
| `insert:comments` | Create comments on pages and discussions |

## Share Integration with Content

After OAuth authentication, users must share the integration with specific pages or databases:

1. Open a Notion page or database
2. Click the **...** menu in the top right
3. Select **Connections** (or **Add connections**)
4. Find and select your integration name
5. Click **Confirm**

<Note>
  The integration can only access content that has been explicitly shared with it. This is a Notion security feature to ensure users have control over what data integrations can access.
</Note>

## Configure CrewAI Helm Values

Add your Notion credentials to your CrewAI Helm values:

```yaml theme={null}
oauth:
  enabled: true
  secrets:
    notion:
      clientId: "your-notion-oauth-client-id"
      clientSecret: "your-notion-oauth-client-secret"
```

See [Built-in Integrations Configuration](/reference/chart-values/oauth) for complete configuration options.

## Activate the Integration

After deploying your updated Helm values, sync integrations to make them available to users — see [Activate Integrations After Deployment](/features/built-in-integrations-overview#activate-integrations-after-deployment).

## Related Guides

* [Google Workspace Integrations](/features/google-integrations) - Gmail, Calendar, Drive, Sheets, Slides, Docs, Contacts
* [Microsoft 365 Integrations](/features/microsoft-integrations) - Outlook, OneDrive, Teams, SharePoint, Excel, Word
* [HubSpot Integration](/features/hubspot-integration) - CRM contacts, deals, companies, tickets