Microsoft OneNote

Access your OneNote notebooks, sections, and pages in MeinGPT

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. Four optional write functions — creating notebooks, sections, and pages, and permanently deleting pages — exist but are disabled by default and must be explicitly enabled by an administrator.

When to Use

Ideal for:

  • Browsing and reading notebooks, sections, and pages
  • Retrieving the content of a specific page as text
  • Finding recently modified pages or searching by title

Not suited for:

  • Full-text search across a page's entire content (search matches only titles and metadata)
  • Write actions, unless an administrator has explicitly enabled the optional write functions
  • Changing, overwriting, or appending to existing pages (only new pages can be created)
  • Personal Microsoft accounts (only work, school, or university accounts are supported)

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 notebook: set up a new personal notebook
  • Create a section in an allowed notebook
  • Create a page: add a plain-text page in an allowed section
  • 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: notebooks, sections, and pages are never created or deleted unless an administrator explicitly enables the optional write functions. Page deletion is permanent.
  • Existing pages cannot be edited: the assistant can create new pages, but it cannot change, overwrite, or append to the content of an existing page. This also applies to pages the assistant created itself. If you need a change, ask the assistant to create a new page with the revised text, or edit the page directly in OneNote.
  • 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

  • Live retrieval, no index: MeinGPT reads content from OneNote only when a request needs it, through the Microsoft Graph API in the context of your account. No persistent index of your notebooks is created and there is no background synchronization.

  • Processing: The retrieved content is sent as part of the chat to the AI model the chat runs on. That model's hosting region applies; models that process outside the EU are flagged in the model selection (see Data flow in MeinGPT chats).

  • What is stored: the chat history including tool results (for example the text of a page that was read). Delete chat archives the chat; messages and tool results stay stored and are not permanently deleted.

  • Credentials: MeinGPT never sees your Microsoft password. Only the connection's OAuth tokens are stored, encrypted.

  • Access is limited to resources your account is allowed to see

  • You can revoke the connection at any time in your Microsoft account settings

  • More on data protection and data flow: Is my data secure?

Was this page helpful?