> 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.

# Onenote

> Onenote 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/onenote/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=20260807T163018Z&X-Amz-Expires=604800&X-Amz-Signature=c6faee94df1716052dcb5c0a18dea18b295d4dbf775d7f559ab09a32768ccfe3&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject" alt="Onenote logo" width="48" height="48" />

<h1>
  Onenote
</h1>

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

## Configuration

Microsoft OneNote source connector integrates with the Microsoft Graph API.

Synchronizes data from Microsoft OneNote including notebooks, sections, and pages.

It provides comprehensive access to OneNote resources with proper token refresh
and rate limiting.

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

Explore the Onenote 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:

#### OneNoteNotebookEntity

Schema for a Microsoft OneNote notebook.

Reference:
[https://learn.microsoft.com/en-us/graph/api/resources/notebook](https://learn.microsoft.com/en-us/graph/api/resources/notebook)

| Field              | Type                       | Description                                                           |
| ------------------ | -------------------------- | --------------------------------------------------------------------- |
| id                 | str                        | Notebook ID.                                                          |
| display\_name      | str                        | The name of the notebook.                                             |
| is\_default        | Optional\[bool]            | Indicates whether this is the user's default notebook.                |
| is\_shared         | Optional\[bool]            | Indicates whether the notebook is shared with other users.            |
| user\_role         | Optional\[str]             | The current user's role in the notebook (Owner, Contributor, Reader). |
| created\_by        | Optional\[Dict\[str, Any]] | Identity of the user who created the notebook.                        |
| last\_modified\_by | Optional\[Dict\[str, Any]] | Identity of the user who last modified the notebook.                  |
| links              | Optional\[Dict\[str, Any]] | Links for opening the notebook.                                       |
| self\_url          | Optional\[str]             | The endpoint URL where you can get details about the notebook.        |
| web\_url\_override | Optional\[str]             | Direct URL to open the notebook in OneNote.                           |

#### OneNoteSectionGroupEntity

Schema for a Microsoft OneNote section group.

Section groups are containers that can hold sections and other section groups.

Reference:
[https://learn.microsoft.com/en-us/graph/api/resources/sectiongroup](https://learn.microsoft.com/en-us/graph/api/resources/sectiongroup)

| Field                      | Type                       | Description                                                                             |
| -------------------------- | -------------------------- | --------------------------------------------------------------------------------------- |
| notebook\_id               | str                        | ID of the notebook this section group belongs to.                                       |
| parent\_section\_group\_id | Optional\[str]             | ID of the parent section group, if nested.                                              |
| display\_name              | str                        | The name of the section group.                                                          |
| created\_by                | Optional\[Dict\[str, Any]] | Identity of the user who created the section group.                                     |
| last\_modified\_by         | Optional\[Dict\[str, Any]] | Identity of the user who last modified the section group.                               |
| sections\_url              | Optional\[str]             | The endpoint URL where you can get all the sections in the section group.               |
| section\_groups\_url       | Optional\[str]             | The endpoint URL where you can get all the section groups nested in this section group. |

#### OneNoteSectionEntity

Schema for a Microsoft OneNote section.

Sections contain pages and can belong to a notebook or section group.

Reference:
[https://learn.microsoft.com/en-us/graph/api/resources/section](https://learn.microsoft.com/en-us/graph/api/resources/section)

| Field                      | Type                       | Description                                                      |
| -------------------------- | -------------------------- | ---------------------------------------------------------------- |
| notebook\_id               | str                        | ID of the notebook this section belongs to.                      |
| parent\_section\_group\_id | Optional\[str]             | ID of the parent section group, if any.                          |
| id                         | str                        | Section ID.                                                      |
| display\_name              | str                        | The name of the section.                                         |
| is\_default                | Optional\[bool]            | Indicates whether this is the user's default section.            |
| created\_by                | Optional\[Dict\[str, Any]] | Identity of the user who created the section.                    |
| last\_modified\_by         | Optional\[Dict\[str, Any]] | Identity of the user who last modified the section.              |
| pages\_url                 | Optional\[str]             | The endpoint URL where you can get all the pages in the section. |
| web\_url\_override         | Optional\[str]             | Direct URL to open the section.                                  |

#### OneNotePageFileEntity

Schema for a Microsoft OneNote page as a file entity.

Pages are the actual content containers in OneNote.
Extends FileEntity to leverage Airweave's HTML processing pipeline.

Reference:
[https://learn.microsoft.com/en-us/graph/api/resources/onenotepage](https://learn.microsoft.com/en-us/graph/api/resources/onenotepage)

| Field              | Type                       | Description                                                 |
| ------------------ | -------------------------- | ----------------------------------------------------------- |
| id                 | str                        | Page ID.                                                    |
| notebook\_id       | str                        | ID of the notebook this page belongs to.                    |
| section\_id        | str                        | ID of the section this page belongs to.                     |
| title              | str                        | The title of the page.                                      |
| content\_url       | Optional\[str]             | The URL for the page's HTML content.                        |
| level              | Optional\[int]             | The indentation level of the page (for hierarchical pages). |
| order              | Optional\[int]             | The order of the page within its parent section.            |
| created\_by        | Optional\[Dict\[str, Any]] | Identity of the user who created the page.                  |
| last\_modified\_by | Optional\[Dict\[str, Any]] | Identity of the user who last modified the page.            |
| links              | Optional\[Dict\[str, Any]] | Links for opening the page in OneNote client or web.        |
| user\_tags         | Optional\[List\[str]]      | User-defined tags associated with the page.                 |
| web\_url\_override | Optional\[str]             | Direct URL to open the page in OneNote.                     |

{/* AUTO-GENERATED CONTENT END */}