OneNote

Connect your AI agents to OneNote.

Available Tools

list_notebooks

List the user’s OneNote notebooks. Supports pagination with top/skip, sorting with orderby, and OData filtering. Expand ‘sections’ or ‘sectionGroups’ to include children.

get_notebook

Get a specific OneNote notebook by ID. Use list_notebooks to find valid notebook IDs. Expand ‘sections’ or ‘sectionGroups’ to include children.

create_notebook

Create a new OneNote notebook with the given display name. The name must be unique across the user’s notebooks. Max 128 characters.

copy_notebook

Copy a OneNote notebook. This is an async operation - returns an operation URL to poll for status. Use list_notebooks to find valid notebook IDs.

get_recent_notebooks

Get a list of recently accessed OneNote notebooks, including notebooks from other users shared with the current user.

get_default_notebook

Get the user’s default OneNote notebook. Returns the notebook marked as default, or the first notebook if none is marked as default.

list_pages

List OneNote pages in a specific section. Always requires section_id for performance (global page listing can fail). Use list_sections to find valid section IDs.

get_page

Get OneNote page metadata by ID (title, dates, links). Does NOT include content - use get_page_content for HTML body. Use list_pages to find valid page IDs.

get_page_content

Get the HTML content of a OneNote page. Set include_ids=true to get data-id attributes needed for PATCH updates. Use list_pages to find valid page IDs.

create_page

Create a new OneNote page in a section. Provide HTML content (e.g. ‘<p>Hello</p>’). The title becomes the page heading. Use list_sections to find valid section IDs.

update_page

Update a OneNote page using PATCH operations.

delete_page

Delete a OneNote page permanently. This action cannot be undone. Use list_pages to find valid page IDs.

copy_page

Copy a OneNote page to a different section. Async operation - returns operation URL to poll. Use list_pages and list_sections to find valid IDs.

list_section_groups

List OneNote section groups. Filter by notebook_id to list groups in a specific notebook, or omit to list all section groups. Use list_notebooks to find valid IDs.

get_section_group

Get a specific OneNote section group by ID. Expand ‘sections’ or ‘sectionGroups’ to include children. Use list_section_groups to find valid IDs.

create_section_group

Create a new OneNote section group in a notebook. Section groups organize sections into folders. Use list_notebooks to find valid notebook IDs.

list_sections

List OneNote sections. Filter by notebook_id or section_group_id, or omit both to list all sections. Use list_notebooks to find valid notebook IDs.

get_section

Get a specific OneNote section by ID. Use list_sections to find valid section IDs. Expand ‘pages’ or ‘parentNotebook’ to include related data.

create_section

Create a new OneNote section in a notebook or section group. Provide either notebook_id or section_group_id. Use list_notebooks to find valid IDs.

copy_section_to_notebook

Copy a OneNote section to a different notebook. Async operation - returns operation URL. Use list_sections and list_notebooks to find valid IDs.

copy_section_to_section_group

Copy a OneNote section to a section group. Async operation - returns operation URL. Use list_sections and list_section_groups to find valid IDs.