> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.airweave.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.airweave.ai/_mcp/server.

# Notion

> Notion integration with Airweave

{/* AUTO-GENERATED CONTENT START */}

<img src="https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/airweave.docs.buildwithfern.com/2026-05-20T11%3A36%3A51.367Z/docs/pages/connectors/notion/icon.svg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260807%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260807T163133Z&X-Amz-Expires=604800&X-Amz-Signature=d2935a95813001be4e9fea2e4029b39adced89f67b05dfa5bce5b8b0bc29648b&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject" alt="Notion logo" width="48" height="48" />

<h1>
  Notion
</h1>

This connector enables AI agents and RAG systems to retrieve context from Notion through Airweave's unified search layer.

## Configuration

Notion source connector integrates with the Notion API to extract and synchronize content.

Connects to your Notion workspace.

It provides comprehensive access to databases, pages, and content with advanced content
aggregation, lazy loading, and file processing capabilities for optimal performance.

#### [View Source Code](https://github.com/airweave-ai/airweave/tree/main/backend/airweave/platform/sources/notion.py)

Explore the Notion connector implementation

### Authentication

This connector uses **OAuth 2.0 authentication**. You can connect through the Airweave UI or API using the OAuth flow.

**Supported authentication methods:**

* OAuth Browser Flow (recommended for UI)
* OAuth Token (for programmatic access)
* Auth Provider (enterprise SSO)

### Configuration Options

This connector does not have any additional configuration options.

## Data Models

The following data models are available for this connector:

#### NotionDatabaseEntity

Schema for a Notion database.

| Field            | Type                       | Description                                        |
| ---------------- | -------------------------- | -------------------------------------------------- |
| database\_id     | str                        | The ID of the database.                            |
| title            | str                        | The title of the database                          |
| created\_time    | Optional\[datetime]        | When the database was created.                     |
| updated\_time    | Optional\[datetime]        | When the database was last edited.                 |
| description      | str                        | The description of the database                    |
| properties       | Dict\[str, Any]            | Database properties schema                         |
| properties\_text | Optional\[str]             | Human-readable schema description                  |
| parent\_id       | str                        | The ID of the parent                               |
| parent\_type     | str                        | The type of the parent (workspace, page\_id, etc.) |
| icon             | Optional\[Dict\[str, Any]] | The icon of the database                           |
| cover            | Optional\[Dict\[str, Any]] | The cover of the database                          |
| archived         | bool                       | Whether the database is archived                   |
| is\_inline       | bool                       | Whether the database is inline                     |
| url              | str                        | The URL of the database                            |

#### NotionPageEntity

Schema for a Notion page with aggregated content.

| Field                  | Type                       | Description                                                      |
| ---------------------- | -------------------------- | ---------------------------------------------------------------- |
| page\_id               | str                        | The ID of the page.                                              |
| parent\_id             | str                        | The ID of the parent                                             |
| parent\_type           | str                        | The type of the parent (workspace, page\_id, database\_id, etc.) |
| title                  | str                        | The title of the page                                            |
| created\_time          | Optional\[datetime]        | When the page was created.                                       |
| updated\_time          | Optional\[datetime]        | When the page was last edited.                                   |
| content                | Optional\[str]             | Full aggregated content                                          |
| properties             | Dict\[str, Any]            | Formatted page properties for search                             |
| properties\_text       | Optional\[str]             | Human-readable properties text                                   |
| property\_entities     | List\[Any]                 | Structured property entities                                     |
| files                  | List\[Any]                 | Files referenced in the page                                     |
| icon                   | Optional\[Dict\[str, Any]] | The icon of the page                                             |
| cover                  | Optional\[Dict\[str, Any]] | The cover of the page                                            |
| archived               | bool                       | Whether the page is archived                                     |
| in\_trash              | bool                       | Whether the page is in trash                                     |
| url                    | str                        | The URL of the page                                              |
| content\_blocks\_count | int                        | Number of blocks processed                                       |
| max\_depth             | int                        | Maximum nesting depth of blocks                                  |

#### NotionPropertyEntity

Schema for a Notion database page property.

| Field            | Type           | Description                                       |
| ---------------- | -------------- | ------------------------------------------------- |
| property\_key    | str            | Stable unique identifier for the property entity. |
| property\_id     | str            | The ID of the property                            |
| property\_name   | str            | The name of the property                          |
| property\_type   | str            | The type of the property                          |
| page\_id         | str            | The ID of the page this property belongs to       |
| database\_id     | str            | The ID of the database this property belongs to   |
| value            | Optional\[Any] | The raw value of the property                     |
| formatted\_value | str            | The formatted/display value of the property       |

#### NotionFileEntity

Schema for a Notion file.

Reference:
[https://developers.notion.com/reference/file-object](https://developers.notion.com/reference/file-object)

| Field           | Type                | Description                                         |
| --------------- | ------------------- | --------------------------------------------------- |
| file\_id        | str                 | ID of the file in Notion                            |
| file\_name      | str                 | Display name of the file                            |
| expiry\_time    | Optional\[datetime] | When the file URL expires (for Notion-hosted files) |
| caption         | str                 | The caption of the file                             |
| web\_url\_value | Optional\[str]      | Link to view/download the file.                     |

{/* AUTO-GENERATED CONTENT END */}