Microsoft OneNote

The OneNote integration connects meinGPT to your OneNote notebooks via Microsoft Graph. You can browse notebooks, sections, and pages, and read the content of individual pages as clean text. The integration is read-only by default. Two optional write functions, creating sections and permanently deleting pages, exist but are disabled by default and must be explicitly enabled by an administrator.

Overview

Execution runs in user context: calls use the permissions of your authenticated account. Your OneNote permissions at the notebook, section, and page level stay intact.

You can:

• List notebooks you have access to
• List sections and section groups of a notebook
• List pages, either of a section or the most recently modified pages across all sections, with a title filter
• Search pages by title and keywords
• Read page content: the body of a single page is returned as clean markdown

With the optional write functions enabled (off by default):

• Create a section in an allowed notebook
• Permanently delete a page: this cannot be undone and requires the write permission (Notes.ReadWrite)

Setup

The integration uses OAuth. No manual API key is required.

1. Activate tool: Select OneNote in your assistant
2. Authentication: On first use, you are redirected to Microsoft
3. Select account: Use your work, school, or university account (personal Microsoft accounts are not supported)
4. Confirm permissions: Read OneNote (Notes.Read). If the write functions are enabled and allowed by your organization's policy, write access (Notes.ReadWrite) is requested as well
5. Done: You can start working with OneNote right away

Restrict to notebooks

You can optionally restrict the tool to selected notebooks ("Restrict to Notebooks"). Leave the list empty for full access. When notebooks are selected, the assistant can only access those notebooks and their pages. A restriction at the assistant level can only narrow your own connection restriction, never widen it.

Examples

"List my OneNote notebooks"
"Show the sections in the Projects notebook"
"Which pages were modified most recently?"
"Search OneNote pages about onboarding"
"Read me the content of the Kickoff Notes page"

Limitations

• Read-only by default: pages are never created, changed, or deleted unless an administrator explicitly enables the optional section-creation and page-deletion functions. Page deletion is permanent.
• No full-text content search: search matches titles and metadata, not a page's full body text. For search across large estates, use data pools.
• Images and external content: embedded images are not downloaded; they appear as placeholders in the text.
• Throttling: OneNote content reads are heavily rate-limited, so page content is fetched one page at a time and only on demand.
• No notifications: the OneNote Graph API has no webhooks, so there is no background synchronization.
• Business account required: personal Microsoft accounts are not supported. Microsoft retired app-only OneNote Graph access in 2025, so this connector runs in user context only.

Privacy and security

• Authentication is secure via OAuth 2.0
• meinGPT does not store Microsoft credentials
• Access is limited to resources your account is allowed to see
• You can revoke the connection at any time in your Microsoft account settings