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

# Let AI Agents Read and Write OneNote Notebooks

> Let agents read OneNote notebooks, sections, and pages, and create or edit notes. Connect with Microsoft OAuth, and the gateway keeps tokens hidden.

## Overview

Buckle connects AI agents to Microsoft OneNote through Microsoft's OAuth flow. Agents can read notebooks, sections, and pages, create new pages, and edit existing content. The gateway injects OAuth credentials into requests to the Microsoft Graph API automatically.

> [!NOTE]
>
> On self-hosted Buckle, Microsoft OneNote needs your own Microsoft app first. See [Self-hosted](#self-hosted).

## What you will set up

* A Microsoft OneNote connection through Microsoft OAuth
* Automatic token injection on Microsoft Graph requests
* Per-agent, per-tool access to your notebooks

## Setup

**1. Open the app**

Open the Buckle dashboard and navigate to **Settings** > **Apps** > **Microsoft OneNote**.

**2. Authorize**

Click **Connect Microsoft OneNote**. You'll be redirected to Microsoft to sign in and authorize Buckle. Review the requested permissions and click **Accept**.

![Buckle connect window for Microsoft OneNote on Cloud, showing the Connect to Microsoft OneNote button.](https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/microsoft-onenote/buckle-connect-microsoft-onenote.png?fit=max\&auto=format\&n=h1DTAVlDkLshz4JZ\&q=85\&s=57c45992dd6e79e5ebc5e0dc78724eff)

The Microsoft OneNote connect window on Buckle Cloud.

**3. Verify**

After authorization, you'll be redirected back to the dashboard. The connection will show as **Connected** with your Microsoft account email.

## Self-hosted: use your own Microsoft app

> [!NOTE]
>
> **Skip this section on Buckle Cloud.** It's only for self-hosted Buckle without `MICROSOFT_CLIENT_ID` and `MICROSOFT_CLIENT_SECRET` set. One Microsoft app serves all four Microsoft apps in Buckle, so you set it up once.

> [accordion] Set up your Microsoft app
>
> Follow [Self-hosted: use your own Microsoft app](/docs/integrations/outlook-mail.md#self-hosted) on the Outlook Mail page. If you already have one for another Microsoft app, it already works here. Then open **Settings** > **Apps** > **Microsoft OneNote** and select **Connect Microsoft OneNote**.
>
> ![Buckle Custom credentials card for Microsoft OneNote with the setup guide link, the Redirect URI and its copy button, and the Client ID and Client Secret fields.](https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/microsoft-onenote/buckle-custom-credentials-microsoft-onenote.png?fit=max\&auto=format\&n=h1DTAVlDkLshz4JZ\&q=85\&s=13472231a01f52b1e297fd6086cd23b2)
>
> Custom credentials for Microsoft OneNote in Buckle. The Microsoft app is shared, so the same client works here.

## What agents can do

| Area | Description |
| - | - |
| **Read notebooks** | View your OneNote notebooks, sections, and pages |
| **Read & write notebooks** | View, create, and edit notebooks, sections, and pages |
| **Create pages** | Create new pages in your OneNote notebooks |

## Use cases

* Note-taking agents that create meeting notes from transcripts
* Research agents that organize findings into structured notebooks
* Agents that search across notebooks for relevant information
* Content agents that create and update documentation in OneNote

## Controlling access

Access is per agent: [grant](/docs/guides/agent-access.md) the connection to each agent that needs it, choosing per tool what runs freely, what needs human approval, and what stays blocked — a read-only agent is a single grant. Organization [rules](/docs/guides/rules.md) add guardrails on top, like rate limits and blanket blocks. Everything is checked before credential injection, so a blocked request never reaches the Microsoft Graph API.

## FAQ

> [accordion] Does the agent see my Microsoft token?
>
> No. The token stays in Buckle, and the gateway adds it at the proxy. See [How it works](/docs/how-it-works.md).

> [accordion] Can an agent read notes without editing?
>
> Yes. A read-only agent is a single [grant](/docs/guides/agent-access.md).

> [accordion] How do I reconnect OneNote?
>
> Open **Settings** > **Apps** > **Microsoft OneNote** and connect again. Agents with access use the new connection automatically.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.