Integration · Docs and data
AI agents for OneNote
Read the signed-in person's OneNote notebooks, sections and pages, find pages by title, read a page's content, create pages.
- Actions
- 10
- Read
- 5
- Write
- 5
Actions
What your agents can do in OneNote
Read the signed-in person's OneNote notebooks, sections and pages, find pages by title, read a page's content, create pages (with an image or an attached file), add notes to the end of an existing page, and create notebooks and sections. Works with Microsoft 365 and personal Microsoft accounts.
Read 5
Look things up. Nothing changes.
List notebooks
Lists the signed-in person's OneNote notebooks, most recently changed first.
List sections
Lists the sections in one notebook (by its ID), or in every notebook when no ID is given: each section's id, displayName, isDefault, lastModifiedDateTime, links and parentNotebook (id and name).
List a section's pages
Lists the pages in one section by its ID, most recently changed first (20 unless limit says otherwise, at most 100).
Find pages by title
Finds pages across all of the person's notebooks whose title contains the words given.
Get page content
Reads one page's content by its ID as OneNote's HTML (title, text, lists, tables, and links to images and attachments rather than the files).
Write 5
Create, change or send.
Add notes to a page
Adds content to the end of an existing page by its ID: HTML such as <p>Follow up on Friday</p>, a <ul> list or a <table>.
Create a page
Creates a page in a section, by the section's ID, with a title and HTML content such as <p>Agenda</p><ul><li>Budget</li></ul> or a <table>.
Create a page with a file
Creates a page in a section with a title, optional HTML content, and a file: shown on the page as an image (JPEG, PNG, GIF) or added as an attachment (a PDF, a document).
Create a notebook
Creates a notebook in the person's OneDrive.
Create a section
Creates a section in a notebook, by the notebook's ID.
A person can approve first
Any write action can be set to wait for a person's approval before it runs, so an agent asks before it changes anything.
Connection
How it connects
Connect it once in the console, then give it to the agents and workflows that need it.
Sign in with Microsoft and approve access (OAuth).
Kept safe
- Credentials are stored encrypted with your organization's own keys.
- They are opened only by the process that makes the call, at the moment it runs, and never go into a prompt or the browser.
- Calls go only to the tool's own servers.
Ideas
Ideas to start with
Starting points made only from the actions above. Mix them with any other tool your agents can use.
- 01
Ask about your OneNote data
Ask a question in plain words. The agent can list notebooks, list sections or list a section's pages in OneNote, then answers with what it found.
- 02
Let an agent update OneNote
Have the agent add notes to a page or create a page in OneNote as part of a larger task. Turn on approval and a person signs off on each change first.
- 03
Share what it finds in Slack
Give one agent OneNote and Slack: it can list notebooks in OneNote and post a summary to a Slack channel in the same run.
FAQ
OneNote and MyDeepAgents
Can MyDeepAgents connect to OneNote?
Yes. The OneNote connector has 10 actions: 5 read and 5 make changes. Your agents can call them as tools, and your workflows can run them as steps.
How do I connect OneNote?
Sign in with Microsoft and approve access (OAuth). Credentials are stored encrypted with your organization's own keys and are opened only at the moment of a call.
Can an agent change data in OneNote without asking?
Only if you let it. Each of the 5 actions that change data can be set to wait for a person's approval before it runs.
Can I use OneNote in workflows as well as agents?
Yes. Every OneNote action also works as a step in a workflow, and the same connection serves your agents and your workflows.
Early access
Put OneNote to work
Connect it in a few minutes, give an agent the actions it needs, and decide which changes wait for a person.