Microsoft OneNote
ProductivityTurn OneNote into an agent-writable knowledge surface. Agents create pages from HTML, append structured updates to existing pages, scaffold notebooks and sections, read page content as XHTML, and run async copy operations with built-in polling.
What This Integration Enables
A notes tool is only a system of record if writing to it does not depend on human discipline, and human discipline is exactly what evaporates in a busy week. This connector makes OneNote an agent-writable knowledge surface through the Microsoft Graph API: FlowRunner agents create pages from HTML with images rendered inline, append structured updates to existing pages with targeted change commands, scaffold notebooks and sections for new projects, read page content back as XHTML for downstream processing, and run OneNote's asynchronous copy operations with built-in polling so a template duplication either completes or fails loudly. - File meeting recaps, form submissions, and AI-generated summaries as pages the moment they exist - Append log entries and status updates to a running page instead of scattering them across new ones - Duplicate a template notebook or section per client and track the async copy to completion - Extract page content as XHTML to feed summarization, task creation, or search indexing - Gate permanent deletions behind [human-in-the-loop](/concepts/human-in-the-loop) review, because a deleted page takes its history with it
Without FlowRunner
With FlowRunner
Use Case Scenarios
The project record that writes itself
A recap thread arrives in [Outlook](/integrations/outlook). The agent files it with Create Page into the project's section, then reads the running decisions page with Get Page Content, element IDs included, and appends the newly confirmed decisions with Update Page Content. Extracted action items become tasks in [Microsoft To Do](/integrations/microsoft-todo), each linking back to the OneNote page that justifies it. Six months later, the question "why did we choose this vendor" has a dated, linkable answer instead of an archaeology project.
A notebook scaffold for every new engagement
When a deal closes in the CRM, the agent runs Copy Notebook against the firm's template, which lands the copy in the OneDrive Documents library and polls until the operation completes. Get Operation Status confirms the created notebook's ID, Create Section adds engagement-specific sections, and Create Page drops in a kickoff page prefilled with the client's details. The consultant opens a notebook that looks exactly like the last twenty, and files from [Microsoft OneDrive](/integrations/microsoft-onedrive) link straight into it.
Turning a static notebook into a queryable knowledge base
On a schedule, the agent walks each section with List Section Pages, pulls anything modified since the last run with Get Page Content, and hands the XHTML to a summarization step. Summaries and metadata land in a search index, and a digest of changed pages posts to [Microsoft Teams](/integrations/microsoft-teams). The notebook keeps its role as the writing surface; the agent gives it a read path the rest of the company can actually use.
Human-in-Loop Highlight
Delete Page permanently removes a page and everything on it, and in a knowledge workflow the page being deleted is, by definition, one somebody once thought worth writing down. So archive and cleanup agents never pull that trigger on their own. A quarterly sweep lists candidate pages, shows the owner each page's title, last modified date, and a content excerpt pulled with Get Page Content, and proposes a disposition: copy to the archive section with Copy Page To Section, or delete. Copies run at machine speed the moment they are approved. Delete Page waits for an explicit yes, page by page, because the cost of re-asking a question is minutes and the cost of a deleted decision record is a repeated mistake.
Agent Capabilities
23 actionsNotebooks
6- List Notebooks Retrieves the signed-in user's notebooks with ID, display name, default flag, user role, sharing status, and OneNote links. Supports OData filtering, ordering, paging, and expanding sections inline.
- Get Notebook Retrieves a single notebook by ID, including its display name, sharing status, timestamps, and OneNote links.
- Create Notebook Creates a new notebook with the given name. Names must be unique, at most 128 characters, and free of OneNote's reserved characters.
- List Notebook Sections Retrieves the sections directly under a notebook. Sections nested inside section groups are not included; use List Section Group Sections for those.
- Create Section Creates a new section directly under a notebook. Section names must be unique within the notebook and at most 50 characters.
- Copy Notebook Copies a notebook to the Notebooks folder in the user's OneDrive Documents library. The copy runs asynchronously; by default the action polls until completion and returns the created notebook's ID.
Section Groups
4- List Section Groups Retrieves section groups, including nested groups, across all notebooks or within a specific notebook, with parent notebook references and URLs for child sections.
- Get Section Group Retrieves a single section group by ID, including its parent notebook and parent section group.
- List Section Group Sections Retrieves the sections directly under a specific section group.
- Create Section in Section Group Creates a new section inside a section group, with the same naming rules as Create Section.
Sections
5- List Sections Retrieves all sections across all notebooks, including those nested in section groups, with parent notebook and pages URL.
- Get Section Retrieves a single section by ID, including its parent notebook, parent section group, and timestamps.
- List Section Pages Retrieves the pages of a specific section, newest modified first, up to 100 per call with offset paging. The recommended way to enumerate pages on accounts with many sections.
- Copy Section To Notebook Copies a section with all of its pages into a target notebook. Asynchronous, with built-in polling and the created section's ID on completion.
- Copy Section To Section Group Copies a section with all of its pages into a target section group. Asynchronous, with built-in polling and the created section's ID on completion.
Pages
7- List Pages Retrieves page metadata across all notebooks, newest modified first, with OData filtering and offset paging. Full-text search is available on personal Microsoft accounts; work and school accounts with many sections should prefer List Section Pages.
- Get Page Retrieves a single page's metadata by ID: title, timestamps, content URL, parent section, and OneNote links.
- Get Page Content Retrieves the full page content as an XHTML string, including structure, text, and resource links. Enable Include Element IDs to receive the generated IDs most Update Page Content commands target.
- Create Page Creates a new page in a section from a title and HTML body, or a complete raw XHTML document. Supports standard HTML elements and images referenced by public URL, which OneNote downloads and renders on the page.
- Update Page Content Updates an existing page by applying change commands: append HTML to the end of the page, or insert, prepend, and replace specific elements targeted by data-id, generated element ID, or the keywords body and title. External image URLs are not supported here, unlike Create Page.
- Copy Page To Section Copies a page into a target section. Asynchronous, with built-in polling and the created page's ID on completion.
- Delete Page Permanently deletes a page and all of its content. The operation this page's human gate exists for.
Operations
1- Get Operation Status Retrieves the status of a long-running copy operation started by Copy Notebook, Copy Section To Notebook, Copy Section To Section Group, or Copy Page To Section. Completed operations return the created resource's ID; failed ones return error details.
Frequently Asked Questions
What can FlowRunner do with Microsoft OneNote?
FlowRunner agents can run List Notebooks, Get Notebook, and Create Notebook in Microsoft OneNote, plus 20 more actions.
Does connecting Microsoft OneNote to FlowRunner require OAuth?
Yes. Microsoft OneNote connects to FlowRunner with OAuth 2.0, so agents authenticate without handling raw credentials.
Can Microsoft OneNote trigger a FlowRunner workflow automatically?
Microsoft OneNote doesn't currently expose triggers in FlowRunner. It connects as an action step inside workflows started by another trigger.
Start building with Microsoft OneNote
$100 in credits. No card required. Connect in minutes.