--- title: "Microsoft OneNote Integration" description: "Turn 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." url: https://flowrunner.ai/integrations/microsoft-onenote date_modified: 2026-08-01T02:40:32-07:00 --- # Microsoft OneNote [Productivity](https://flowrunner.ai/integrations/category/project-management-productivity) Turn 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. [Verified](https://flowrunner.ai/integrations/verified "What does verified mean?") · 23 actions · OAuth · available [Microsoft OneNote website](https://www.microsoft.com/en-us/microsoft-365/onenote/digital-note-taking-app) · [Platform Documentation](https://learn.microsoft.com/en-us/graph/integrate-with-onenote) · Capability data verified 2026-07-22 1. A meeting recap thread lands in the shared Outlook mailbox for the project 2. Create Page files the recap as a dated page in the project's section, with linked artifacts rendered inline 3. Get Page Content reads the running decisions page as XHTML with element IDs so the append targets the right block 4. The project lead confirms the extracted decisions and owners before anything is written to the page of record 5. Update Page Content appends the confirmed decisions and action items to the decisions page 6. Links to both pages post to the project channel with the new commitments called out ## 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](https://flowrunner.ai/concepts/human-in-the-loop) review, because a deleted page takes its history with it ### Without FlowRunner **Notes exist only if someone types them**: Meeting outcomes, status updates, and research live in whoever's head attended, or nowhere **Every project reinvents its structure**: Each engagement gets an ad hoc notebook layout, so nothing is findable across projects **The notebook is a write-only archive**: Content goes in and is never read again, because extracting it means manual copy and paste ### With FlowRunner **Capture is automatic and structured**: Agents file recaps, summaries, and log entries as pages the moment the source event happens **Structure is scaffolded from a template**: New projects get the same notebook and section layout every time, copied and verified by the agent **Pages feed downstream work**: Agents read page content as XHTML and turn it into tasks, indexes, and summaries ## Use Case Scenarios ### The project record that writes itself A recap thread arrives in [Outlook](https://flowrunner.ai/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](https://flowrunner.ai/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](https://flowrunner.ai/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](https://flowrunner.ai/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 processes routinely Detects exception requiring judgment Clear match Continues automatically Ambiguous Routes to human via preferred channel Human decides Agent resumes with decision ## Agent Capabilities 23 actions ### Notebooks 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. **Work at Microsoft OneNote?** This integration exposes Microsoft OneNote to AI agents on every FlowRunner plan, including through MCP, at no cost to you. [See what FlowRunner offers integration partners](https://flowrunner.ai/integrations/partners), including how to keep this page current. --- Markdown version of https://flowrunner.ai/integrations/microsoft-onenote. Site index: https://flowrunner.ai/llms.txt