Microsoft OneNote
Read notebooks and pages, create pages, and append page content
Connect Microsoft OneNote when a project needs notes from a shared Microsoft account or from each published app user.
Available operations
| Operation | What it does | Permission | Limit per minute |
|---|---|---|---|
list_notebooks | Lists up to 50 notebooks | Read notes | 30 |
list_sections | Lists sections in one notebook | Read notes | 30 |
list_pages | Lists pages in one section | Read notes | 30 |
get_page | Reads sanitized page HTML | Read notes | 30 |
create_page | Creates one page from safe HTML | Manage notes | 10 |
append_page_content | Appends safe HTML to one page body | Manage notes | 10 |
Page content is limited to 64 KiB. Swarmz removes active or unsafe HTML from reads and rejects unsafe HTML on writes.
Connect Microsoft OneNote
An administrator first configures Microsoft OAuth application and enables Microsoft OneNote under Admin > Settings > Integrations.
Ask the AI for the notebook owner and content flow. Examples:
- “List sections from our shared research notebook and show recent pages.”
- “Let each signed-in user add an approved meeting summary to their own OneNote.”
Choose Connect new, approve read or manage access, then select Continue. For a published app-user connection, provide the final HTTPS app origin before authorizing.
Verify Microsoft OneNote
- List notebooks and sections, then choose a disposable test section.
- Create a page titled
Swarmz connector testwith a short paragraph. - Read the page and confirm the sanitized HTML.
- Append a unique test marker and confirm it in OneNote.
- Remove the test page in OneNote.
The connector appends to the page body; it does not replace arbitrary page elements or preserve unsupported active HTML. If a write is rejected, remove scripts, embedded objects, event-handler attributes, inline styles, and unsafe URLs before retrying. Disconnecting leaves existing notes unchanged.