OneNote
Microsoft OneNote connector for managing notebooks, sections, section groups, and pages through Microsoft Graph API.
What you can ask
- Search my notebooks for pages tagged
meeting-notesfrom this week. - Add a new page to the
Engineeringnotebook from this morning's standup transcript. - List every notebook section that hasn't been edited in 6 months.
Set up
OneNote needs an OAuth application from your organization before anyone can connect. An organization admin completes these steps once.
- Go to Organization > Connectors and find OneNote. Click Enable, and choose which tools to allow.
- Create an OAuth application in the OneNote developer portal.
- Add the Redirect URI shown in the connector settings to the application.
- Copy the application's Client ID and Client Secret into the connector, then save it.
- Each member connects their own account the first time they use it.
⚠️ Warning: Do not enter your Devs.ai or OneNote login email or password in the OAuth application fields.
To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.
OAuth scopes used by these tools (3)
Grant the scopes for the tools you plan to allow.
Notes.CreateNotes.ReadNotes.ReadWrite
Tools
OneNote offers 22 tools. Admins choose which ones agents can use. See Tool permission groups.
Read (12)
View and search information without changing it.
| Tool | What it does |
|---|---|
get_default_notebook | Get the user's default OneNote notebook. |
get_notebook | Get a specific OneNote notebook by ID. |
get_page | Get OneNote page metadata by ID (title, dates, links). |
get_page_content | Get the HTML content of a OneNote page. |
get_recent_notebooks | Get a list of recently accessed OneNote notebooks, including notebooks from other users shared with the current user. |
get_section | Get a specific OneNote section by ID. |
get_section_group | Get a specific OneNote section group by ID. |
list_notebooks | List the user's OneNote notebooks. |
list_pages | List OneNote pages in a specific section. |
list_section_groups | List OneNote section groups. |
list_sections | List OneNote sections. |
validate_credential | Validate OneNote credentials. |
Write (8)
Create or send data.
| Tool | What it does |
|---|---|
copy_notebook | Copy a OneNote notebook. |
copy_page | Copy a OneNote page to a different section. |
copy_section_to_notebook | Copy a OneNote section to a different notebook. |
copy_section_to_section_group | Copy a OneNote section to a section group. |
create_notebook | Create a new OneNote notebook with the given display name. |
create_page | Create a new OneNote page in a section. |
create_section | Create a new OneNote section in a notebook or section group. |
create_section_group | Create a new OneNote section group in a notebook. |
Delete or overwrite (2)
Remove or replace existing data.
| Tool | What it does |
|---|---|
delete_page | Delete a OneNote page permanently. |
update_page | Update a OneNote page using PATCH operations. |