| name | onenote |
| description | Read/write OneNote pages via Microsoft Graph or COM |
| category | windows |
| version | 1.0.0 |
| platform | windows |
| tags | onenote, notes, notebook, microsoft, graph, pages, sections |
| license | Apache-2.0 |
OneNote
Access, create, and update OneNote notebooks, sections, and pages using PowerShell COM or Microsoft Graph API — capture meeting notes, append to journals, and query your knowledge base.
When to Use
- User wants to capture meeting notes or action items into OneNote
- User asks to read a specific OneNote page or section
- User wants to create a new page or append content to an existing one
- User needs to list available notebooks and sections
- User wants to search across OneNote pages
How to Use
List notebooks (Graph API)
$headers = @{ Authorization = "Bearer $env:GRAPH_TOKEN" }
Invoke-RestMethod -Uri "https://graph.microsoft.com/v1.0/me/onenote/notebooks" -Headers $headers |
Select-Object -ExpandProperty value |
Select-Object id, displayName, lastModifiedDateTime
List sections in a notebook
$notebookId = "YOUR_NOTEBOOK_ID"
$headers = @{ Authorization = "Bearer $env:GRAPH_TOKEN" }
Invoke-RestMethod -Uri "https://graph.microsoft.com/v1.0/me/onenote/notebooks/$notebookId/sections" -Headers $headers |
Select-Object -ExpandProperty value |
Select-Object id, displayName
Get pages in a section
$sectionId = "YOUR_SECTION_ID"
$headers = @{ Authorization = "Bearer $env:GRAPH_TOKEN" }
Invoke-RestMethod -Uri "https://graph.microsoft.com/v1.0/me/onenote/sections/$sectionId/pages" -Headers $headers |
Select-Object -ExpandProperty value |
Select-Object id, title, createdDateTime
Create a new page in a section
$sectionId = "YOUR_SECTION_ID"
$headers = @{
Authorization = "Bearer $env:GRAPH_TOKEN"
"Content-Type" = "application/xhtml+xml"
}
$html = @"
<!DOCTYPE html>
<html><head><title>Meeting Notes — $(Get-Date -Format 'yyyy-MM-dd')</title></head>
<body>
<h1>Meeting Notes</h1>
<p>Action items:</p>
<ul><li>Follow up with team</li></ul>
</body></html>
"@
Invoke-RestMethod -Uri "https://graph.microsoft.com/v1.0/me/onenote/sections/$sectionId/pages" `
-Method POST -Headers $headers -Body $html
Read page content (HTML)
$pageId = "YOUR_PAGE_ID"
$headers = @{ Authorization = "Bearer $env:GRAPH_TOKEN" }
Invoke-RestMethod -Uri "https://graph.microsoft.com/v1.0/me/onenote/pages/$pageId/content" -Headers $headers
Search pages by keyword
$headers = @{ Authorization = "Bearer $env:GRAPH_TOKEN" }
Invoke-RestMethod -Uri "https://graph.microsoft.com/v1.0/me/onenote/pages?`$search=meeting" -Headers $headers |
Select-Object -ExpandProperty value |
Select-Object title, createdDateTime
Examples
"Create a page in my Daily Notes section with today's date as the title"
→ POST HTML page to the Daily Notes section ID with <title> set to $(Get-Date -Format 'yyyy-MM-dd').
"List all my notebooks"
→ GET /me/onenote/notebooks and display displayName + lastModifiedDateTime.
"Search my notes for action items"
→ GET /me/onenote/pages?$search=action+items and list matching page titles.
Cautions
- Graph API requires
Notes.ReadWrite scope — obtain token via az login or OAuth device flow
- Page content is returned as HTML; parse with PowerShell XML or pass to an HTML renderer
- OneNote COM automation (via
onenote.exe) is less reliable than Graph API for programmatic access
- Large notebooks with many pages may require
$top and $skip pagination parameters