Microsoft OneNote for AI agents

Agents read Microsoft OneNote at once. Changes and sends are held for a person's approval by default.

About Microsoft OneNote

Digital notebook for capturing and organizing notes, drawings, and information

What an agent can do in Microsoft OneNote

Every Microsoft OneNote action is classed by the platform as a read, a change or a send. Reads run at once. Changes and sends are held for a person by default.

Runs at once (reads)

Looks things up in Microsoft OneNote without asking first. 45 actions.

  • Get a OneNote section from a groupRetrieves a specific OneNote section from a Microsoft 365 group. Use this action when you need to fetch metadata or details for a single OneNote section by specifying the group ID and section ID. This
  • Get notebook from web URLRetrieves a OneNote notebook by using its web URL path. Use this action when you have the SharePoint or OneDrive URL of a notebook and need to retrieve its properties and metadata. The webUrl paramete
  • Get notebook section groupRetrieves a specific section group from a OneNote notebook within a Microsoft 365 group. Use this action when you need to get details about a specific section group, including its name, creation/modif
  • Get a OneNote page from a groupRetrieves OneNote page metadata directly by page ID in a Microsoft 365 group. Legacy notebook, section group, and section IDs do not affect the Graph route.
  • Get a OneNote pageRetrieves metadata and properties of a specific OneNote page from the authenticated user's notebooks. Use this action when you need to fetch details about a OneNote page by its ID without navigating t
  • Get recent notebooksRetrieves a list of recently accessed OneNote notebooks for the signed-in user. Use this action when you need to display recently accessed notebooks, provide quick access to notebooks the user has bee
  • Get a OneNote section by IDRetrieves a specific OneNote section by its ID from the current user's OneNote. Use this action when you need to fetch metadata or details for a single OneNote section by specifying only the section I
  • Get a OneNote section from a siteRetrieves a specific OneNote section from a SharePoint site. Use this action when you need to fetch metadata or details for a single OneNote section by specifying the site ID and section ID. This acti
  • Get OneNote page from site (compatibility alias)Compatibility alias for retrieving OneNote page metadata directly by page ID in a SharePoint site. Prefer GetSiteOnenotePages for new calls. Legacy notebook, section group, and section IDs do not affe
  • Get user notebookRetrieves the properties and relationships of a OneNote notebook by ID for a specific user. Use this action when you need to fetch details about a specific notebook belonging to a user, including its
  • Get a OneNote page from userRetrieves a specific OneNote page from a user's OneNote notebooks. Use this action when you need to fetch metadata or details for a single OneNote page directly by page ID and user ID. This is useful
  • Get parent section group from user sectionRetrieves the parent section group of a OneNote section within a user's notebook. Use this action when you need to navigate up the OneNote hierarchy from a section to its parent section group, for exa
Show all 45
  • List group notebooksList OneNote notebooks owned by a Microsoft 365 group or Teams team. Use this with a group or team ID, including IDs returned by List joined teams.
  • List notebook section groupsRetrieves a list of section groups from the specified notebook within a Microsoft 365 group. Use this action to retrieve a page of section groups in a group-owned OneNote notebook to understand its st
  • List pages from a group notebook sectionCompatibility alias for listing a page of OneNote pages from a specific section within a notebook in a Microsoft 365 group. Prefer the canonical ListOnenoteGroupSectionsPages4 action for new calls. Us
  • List joined teamsList Microsoft Teams that a user is a direct member of. Use this to get team IDs, which are also Microsoft 365 group IDs, before listing group-owned OneNote notebooks.
  • List pages in sectionRetrieves a list of OneNote pages from a specific section for the current user. Use this action when you need to retrieve a page of pages from a specific section in the current user's OneNote notebook
  • List group OneNote pagesLists a paginated collection of OneNote pages from a Microsoft 365 group. Use this action to retrieve a page of OneNote pages within a Microsoft 365 group. Supports pagination via page_size. The defau
  • List pages from a group sectionCanonical action for listing a paginated collection of OneNote pages from a specific section in a Microsoft 365 group. Use this action when you need to retrieve a page of pages from a known section in
  • List site notebooksList OneNote notebooks stored in a SharePoint site. Use this after resolving a SharePoint site ID from a site name or URL when the user asks for notebooks in a SharePoint site.
  • List site notebook section groupsRetrieves a list of section groups from the specified notebook within a SharePoint site. Use this action to retrieve a page of section groups in a SharePoint site-owned OneNote notebook to understand
  • List user notebooksLists a paginated collection of OneNote notebooks accessible by a specific user. Use this action when you need to retrieve the available notebooks for a user, display notebook listings, or browse note
  • List user notebook sectionsLists a paginated collection of OneNote sections from a specified user notebook. Use this action when you need to retrieve a page of sections within a notebook that is owned by or accessible to a spec
  • Search SharePoint sitesSearch SharePoint sites available through Microsoft Graph. Use this to find a site ID from a site name or keyword before listing site-hosted OneNote notebooks. Microsoft Graph site search does not sup
  • Validate OneNote credentialsValidates OneNote API credentials by attempting to access the user's notebooks. Use this action when you need to verify that the provided authentication token has valid permissions to access Microsoft
  • Count user section group sectionsGets the provider-reported count of OneNote sections directly within a user's section group. Use this action when you need to quickly determine the number of sections in a section group without retrie
  • Count site section group sectionsGets the provider-reported count of sections directly within a SharePoint site's OneNote section group. Use this action when you need to quickly determine the number of sections in a section group wit
  • Get OneNote resource content by IDRetrieves the binary content of a specific OneNote resource using its ID. Use this action when you need to fetch the raw binary content of an image, file attachment, or other embedded resource from a
  • Get OneNote page content from sectionRetrieves the HTML content of a specific OneNote page from a section for the signed-in user. Use this action when you need to fetch the full HTML content of a OneNote page within a specific section. T
  • Get group OneNote operation statusRetrieves the status of a long-running OneNote operation for a group. Use this action when you need to check whether a copy or sync operation (e.g., CopyNotebook, CopyToNotebook, CopyToSectionGroup, C
  • Get site OneNote operation statusRetrieves the status of a long-running OneNote operation for a SharePoint site. Use this action when you need to check whether a copy or sync operation (e.g., CopyNotebook, CopyToNotebook, CopyToSecti
  • Get OneNote page content for userGets the HTML content of a specific OneNote page for a user. Use this action when you need to retrieve the actual HTML content of a specific OneNote page for reading, processing, or displaying page co
  • Get OneNote page from siteRetrieves a specific OneNote page from a SharePoint site. Use this action when you need to fetch metadata or details for a single OneNote page by its page identifier within a SharePoint site. This act
  • Get site notebook page previewRetrieves a text preview of a specific OneNote page from a SharePoint site or the signed-in user's OneNote. Use this action when you need to quickly get the content preview of a OneNote page from a si
  • Get user OneNote operationPoll the status of a user's asynchronous OneNote operation.
  • List group root section groupsList section groups at the root of a Microsoft 365 group's OneNote hierarchy.
  • List group root sectionsList sections at the root of a Microsoft 365 group's OneNote hierarchy.
  • List section group sectionsLists a paginated collection of OneNote sections from a section group within a Microsoft 365 group's OneNote. Use this action when you need to retrieve the sections contained within a section group in
  • List group section group section groupsLists a paginated collection of nested section groups from a specified parent section group within a Microsoft 365 group's OneNote notebook. Use this action when you need to retrieve the nested sectio
  • Get OneNote page content from SharePoint siteRetrieves the HTML content of a specific OneNote page within a SharePoint site. Use this action when you need to fetch the full HTML content of a OneNote page from a SharePoint site for processing, re
  • List site root section groupsList section groups at the root of a SharePoint site's OneNote hierarchy.
  • List site sectionsRetrieves a list of OneNote sections from a SharePoint site. Use this action to retrieve a page of OneNote sections within a SharePoint site's OneNote notebook to understand its structure or to find a
  • List user pagesList OneNote pages owned by a user, defaulting to the signed-in user.
  • List user root section groupsList root OneNote section groups for a user, defaulting to the signed-in user.
  • List user sectionsList root OneNote sections for a user, defaulting to the signed-in user.

Held for approval by default (changes and sends)

Held for a person's approval by default. The approval is recorded and the action is sent once, never twice, with 10 seconds to undo. 38 actions.

  • Copy notebook in groupCopies a OneNote notebook to the Notebooks folder in the destination Documents library. The notebook is copied asynchronously. This action initiates the copy operation and returns a 202 Accepted respo
  • Copy notebook in siteCopies a OneNote notebook within a SharePoint site. Use this action when you need to duplicate a notebook within a SharePoint site. This is an asynchronous operation. Poll the returned operation URL t
  • Create group OneNote pageCreates a new OneNote page in the default section of the default notebook for a Microsoft 365 group. Use this action when you need to programmatically create a new page in a group's OneNote notebook.
  • Create OneNote page in sectionCreates a new OneNote page in a specific section for the signed-in user. Use this action when you need to create a new page within a specific section of the user's OneNote notebook. The page content m
  • Create user OneNote pageCreates a new OneNote page in the default section of the default notebook for a specific user. Use this action when you need to programmatically create a new page in a user's OneNote notebook. The pag
  • Delete group section pageDeletes a OneNote page within a Microsoft 365 group's OneNote workspace. Canonical action for this group page deletion route. Microsoft Graph returns 204 No Content after accepting the deletion; OneNo
  • Delete OneNote page from sectionDelete a specific OneNote page from a section within a notebook in a group. Compatibility alias for deleting a group OneNote page. Prefer DeleteOnenoteGroupSectionGroupPageContent for new calls. Micro
  • Delete OneNote page from siteDeletes a OneNote page from a SharePoint site. Use this action to delete a OneNote page from a SharePoint site's OneNote workspace. Microsoft Graph returns 204 No Content after accepting the deletion;
  • Delete user OneNote page from sectionDeletes a OneNote page from a section within a section group in a user's notebook. Compatibility alias for deleting a user OneNote page. Prefer DeleteUserPages for new calls. Microsoft Graph returns 2
  • Delete OneNote page for userDeletes a OneNote page from a user's OneNote workspace. Canonical action for this user page deletion route. Microsoft Graph returns 204 No Content after accepting the deletion; OneNote retention polic
  • Resolve SharePoint site by URLResolve a SharePoint site URL or hostname and path to a Microsoft Graph site resource. Use this when the user provides a SharePoint URL and a site ID is needed for OneNote notebook discovery.
  • Update my OneNote sectionUpdates the navigation property sections in me. Use when you need to modify properties of an existing OneNote section, such as renaming it, within the current user's notebooks. This action uses a PATC
Show all 38
  • Update section in site notebookCanonical action for updating a OneNote section in a SharePoint site. Use this action when you need to modify properties of an existing section, such as renaming it. This action uses a PATCH request t
  • Update site section group sectionCompatibility alias for updating a OneNote section in a SharePoint site. Prefer UpdateSiteNotebooksSections for new site calls. Legacy notebook and section-group context does not affect the Graph rout
  • Update section in user notebookUpdates a OneNote section within a user's notebook. Use this action when you need to modify properties of an existing OneNote section, such as renaming it, for a specific user identified by their Micr
  • Copy section to notebook (site context)Copy a site-hosted OneNote section to a notebook natively.
  • Copy section to notebook (user)Copies a OneNote section to a specific notebook for a specified user. Use this action when you need to duplicate an existing OneNote section into a different notebook under a specific user's account.
  • Copy group section to section groupCopies a OneNote section from a Microsoft 365 group's notebook into another section group. Use this action when you need to duplicate an existing OneNote section that lives in a Microsoft 365 group's
  • Copy section to section group (user)Copies a OneNote section to a specific section group for a specified user. Use this action when you need to duplicate an existing OneNote section into a different section group under a specific user's
  • Copy site page to sectionCopy a site-hosted OneNote page to a section natively.
  • Copy user notebookStart an asynchronous copy of a user OneNote notebook.
  • Copy user page to sectionCopy a OneNote page from a user's notebook to a specified section. Use this action when you need to duplicate a OneNote page into a different section within a user's Microsoft 365 account. This is an
  • Create group nested section groupCreate a section group inside another group OneNote section group.
  • Create group notebookCreates a new OneNote notebook within a Microsoft 365 group. Use this action when you need to create a new notebook for storing notes within a specific Microsoft 365 group. The notebook will be owned
  • Create section in section groupCreates a new OneNote section within a specified section group of a Microsoft 365 group. Use this action when you need to add a new section to organize OneNote pages within a section group's hierarchy
  • Create user notebookCreates a new OneNote notebook for the signed-in user. Use this action when you need to create a new personal notebook to organize notes. The notebook will be created in the user's default OneDrive fo
  • Create section in user's section groupCreates a new OneNote section within a specified section group of a notebook for the signed-in user. Use this action when you need to add a new section to organize OneNote pages within a user's sectio
  • Create section group in group notebookCreates a new section group within a OneNote notebook that belongs to a Microsoft 365 group. Use this action when you need to organize sections inside a group notebook by creating a new top-level sect
  • Create site nested section groupCreate a section group inside another site OneNote section group.
  • Create site notebookCreate a OneNote notebook in a SharePoint site.
  • Create section in site notebookCreates a new OneNote section within a specified notebook in a SharePoint site. Use this action when you need to add a new section to organize OneNote pages within a notebook that belongs to a SharePo
  • Create user nested section groupCreate a section group inside another user OneNote section group.
  • Create section in user notebookCreates a new OneNote section within a specified notebook for a specific user. Use this action when you need to add a new section to organize OneNote pages within a notebook that belongs to a specific
  • Create section in user section groupCreates a new OneNote section within a specified section group for a specific user. Use this action when you need to add a new section to organize OneNote pages within a section group's hierarchy for
  • Create user section pageCreates a new OneNote page in a specific section of a user's notebook. Use this action when you need to create a new page directly in a section within a user's OneNote notebook. The page content must
  • Update my OneNote page contentUpdate the content of a OneNote page for the signed-in user. Sends a PATCH request with patch content commands to modify the HTML structure of a OneNote page. Supports appending children, inserting si
  • Update OneNote page contentUpdate the content of a OneNote page within a Microsoft 365 group using HTML patch commands. Use this action when you need to modify the content of an existing OneNote page, such as replacing text, in
  • Update site OneNote page contentUpdate the content of a OneNote page within a SharePoint site. Sends a PATCH request with patch content commands to modify the HTML structure of a OneNote page. Supports appending children, inserting

Changes wait in Needs you

Changes and sends in Microsoft OneNote are held for a person's approval by default. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.

How approvals work

Microsoft OneNote questions

Can an agent change data in Microsoft OneNote on its own?

Not by default. Changes and sends in Microsoft OneNote are held for a person's approval. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.

What can an agent read in Microsoft OneNote?

This connector lists 45 read actions. Reads run at once, without waiting for approval.

How does Microsoft OneNote connect?

It connects with OAuth 2.0. Connectors are built and maintained by third-party developers; availability is confirmed during scoping.

Bring Microsoft OneNote to your agents.