Skip to content

Start building

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 (OAuth)

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.

How we protect your data

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.