Skip to main content

OneNote

Microsoft OneNote connector for managing notebooks, sections, section groups, and pages through Microsoft Graph API.

What you can ask​

  • Search my notebooks for pages tagged meeting-notes from this week.
  • Add a new page to the Engineering notebook from this morning's standup transcript.
  • List every notebook section that hasn't been edited in 6 months.

Set up​

OneNote needs an OAuth application from your organization before anyone can connect. An organization admin completes these steps once.

  1. Go to Organization > Connectors and find OneNote. Click Enable, and choose which tools to allow.
  2. Create an OAuth application in the OneNote developer portal.
  3. Add the Redirect URI shown in the connector settings to the application.
  4. Copy the application's Client ID and Client Secret into the connector, then save it.
  5. Each member connects their own account the first time they use it.

⚠️ Warning: Do not enter your Devs.ai or OneNote login email or password in the OAuth application fields.

To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.

OAuth scopes used by these tools (3)

Grant the scopes for the tools you plan to allow.

  • Notes.Create
  • Notes.Read
  • Notes.ReadWrite

Tools​

OneNote offers 22 tools. Admins choose which ones agents can use. See Tool permission groups.

Read (12)​

View and search information without changing it.

ToolWhat it does
get_default_notebookGet the user's default OneNote notebook.
get_notebookGet a specific OneNote notebook by ID.
get_pageGet OneNote page metadata by ID (title, dates, links).
get_page_contentGet the HTML content of a OneNote page.
get_recent_notebooksGet a list of recently accessed OneNote notebooks, including notebooks from other users shared with the current user.
get_sectionGet a specific OneNote section by ID.
get_section_groupGet a specific OneNote section group by ID.
list_notebooksList the user's OneNote notebooks.
list_pagesList OneNote pages in a specific section.
list_section_groupsList OneNote section groups.
list_sectionsList OneNote sections.
validate_credentialValidate OneNote credentials.

Write (8)​

Create or send data.

ToolWhat it does
copy_notebookCopy a OneNote notebook.
copy_pageCopy a OneNote page to a different section.
copy_section_to_notebookCopy a OneNote section to a different notebook.
copy_section_to_section_groupCopy a OneNote section to a section group.
create_notebookCreate a new OneNote notebook with the given display name.
create_pageCreate a new OneNote page in a section.
create_sectionCreate a new OneNote section in a notebook or section group.
create_section_groupCreate a new OneNote section group in a notebook.

Delete or overwrite (2)​

Remove or replace existing data.

ToolWhat it does
delete_pageDelete a OneNote page permanently.
update_pageUpdate a OneNote page using PATCH operations.
⌘J