Checks the Microsoft sign-in. If not signed in, starts sign-in: by default a browser window opens on the user's computer; with device-code sign-in it returns a URL and code. Relay the returned instructions to the user exactly; after they finish, other OneNote tools work.

Removes the cached Microsoft sign-in for this OneNote server.

Lists the user's OneNote notebooks with their section groups and sections (IDs included). Start here to find section IDs.

Lists sections, optionally within one notebook (including nested section groups) or one section group, optionally filtered by name.

Lists pages (title, dates, location, ID) in a section, a notebook, or across all notebooks. Filter by title text and last-modified date range. Use for 'what did I write this week' style questions.

Finds pages whose title or text contains all the query words. Title matches are searched server-side; text matches scan the most recently modified pages in scope (Microsoft Graph has no full-text OneNote search). Narrow with section_id or notebook_id for thorough results. Text inside screenshots is only matched via alt text; open pages with onenote_get_page to read screenshots.

Reads a page as markdown, with screenshots and other images returned as images you can see. Images appear in the text as [Image N] placeholders. Large screenshots are downscaled here; use onenote_get_page_image with a region to zoom in on small text. Set format=html_with_ids to get element IDs for targeted edits with onenote_update_page.

Returns one image from a page at high resolution, optionally cropped to a region so small text in big screenshots is legible. Region values are fractions of the image (0-1), e.g. the right half is {x:0.5,y:0,width:0.5,height:1}.

Reads many pages at once (text, optionally with images) for summaries and reports, e.g. all pages in a section modified this week. Pages are returned oldest to newest. Either pass page_ids or a scope with filters.

Creates a new page (e.g. a report) in a section. Identify the section by section_id, or by section_name (plus notebook_name if the name is ambiguous). Images: use for local screenshots, for web images (new pages only), or to copy image N from another OneNote page into a report.

Adds or changes content on an existing page. Default appends to the end of the page body. action=prepend adds to the top; insert/replace need a target element id from onenote_get_page with format=html_with_ids (replace overwrites that element). To rename a page use target=title with action=replace and the new title as content. Images: use for local screenshots, for web images, or to copy image N from another OneNote page into a report. Web image URLs are not accepted here.

Creates a section in a notebook or section group.

Creates a new notebook for the signed-in user.

Saves original-resolution images and file attachments from a page to the local folder /root/Downloads/OneNote MCP (e.g. to embed screenshots in a Word or PDF report). Returns the saved file paths.