Report whether the user is signed in to Microsoft, which account is cached, and where the token cache lives. Safe to call at any time; never triggers a sign-in prompt.

Begin sign-in to the Microsoft account that owns the OneNote notebooks. Returns immediately with the instruction the user must follow (a browser is opened, or a device code is shown). It does NOT wait for the user to finish -- poll authStatus afterwards to confirm. Always show the user the returned URL and code verbatim.

Remove the cached Microsoft account and delete the local token cache file. The user must authenticate again afterwards.

START HERE for anything structural. Returns every notebook, section group, and section in ONE call, with IDs and readable paths like "Learn / Cooking". Use this instead of chaining listNotebooks then listSections — it is one request instead of several, and it correctly includes sections nested inside section groups.

List notebooks only. Prefer getOutline — it returns notebooks AND their sections in the same single call.

List sections, including those nested inside section groups. Prefer getOutline unless you specifically want a flat list.

List pages, most recently modified first. Pass a section NAME to scope to one section; omit it to list across all sections.

Read one page by ID. Returns readable text by default; pass format="html" for the raw XHTML, and includeIds=true if you intend to modify the page afterwards.

Find pages by title (fast — one request). Set searchContent=true to also scan page bodies. OneNote provides no server-side full-text search, so that fetches candidate pages; it runs them in parallel and stops early once enough matches are found, but it is still much slower than a title search. Pass section to narrow it dramatically.

Create a new page. Pass the section by NAME — no lookup needed first. If a default section is configured, section can be omitted entirely.

Add content to the end (or start) of an existing page without replacing it.

Create a new section inside a notebook.

Permanently delete a page. This cannot be undone -- confirm the page title with the user before calling.