Use OneNote with your AI.
Connect your account once and let the AI you already use work with it, without building another integration. Connect your AI agent to Microsoft OneNote to search, read, extract, and append content to your personal or enterprise notebooks seamlessly.
Developed, maintained, and hosted by Vinkius.
MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED
Waiting for input…
Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.
Complete set · 7 capabilities
The complete OneNote capability set.
These are the exact actions your AI can choose when you ask it to work with OneNote.
01-04
4 capabilities in this set.
Part of 7 available through OneNote.
- 01
List notebooks
Identifies primary containers necessary to navigate the hierarchical structure of OneNote. List all Microsoft OneNote notebooks
- 02
List pages
Results include the bare page metadata (IDs, titles, timestamps), but notably DO NOT include the heavy internal raw HTML content. Used for structural indexing. List all pages contained within a specific section
- 03
List sections
Sections act as the folders containing the raw pages. Requires passing the parent Notebook ID to query the correct topological children. List all sections contained within a specific notebook
- 04
Search pages
Useful when navigating deep, unindexed trees where discovering a particular keyword manually would exceed logic boundaries. Search page contents globally across all available notebooks
05-07
3 capabilities in this set.
Part of 7 available through OneNote.
- 05
Get notebook
Use this to dive deeper into a container's permissions or basic configurations. Get detailed properties of a specific notebook
- 06
Get page content
By default, OneNote pages are serialized using complex Microsoft Graph HTML formats with proprietary tags. Use this to ingest the actual written text or data. Retrieve the exact raw HTML content of a single page
- 07
List section groups
Used for navigating highly complex, multi-layered textbook hierarchies inside OneNote. List section groups inside a specific notebook
Observed, not estimated
836ms average. Fast in production.
OneNote is checked daily against the live service.
- Fastest day
- 682ms
- Slowest day
- 971ms
- 14-day trend
- Slowing+9%
Connect your client
One URL. Every client.
Activate the Connector, copy your link, and paste it into the client you already use. 7 capabilities arrive ready to run.
Preview access · not provider authentication
The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of OneNote, so you can see the experience inside your AI.
It does not authenticate your account with OneNote. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.
OneNote Connector
You're all set. Choose your MCP client and follow the setup instructions.
https://edge.vinkius.com/vk_preview_v0VuD1Lg72idPZ9fSLCb2mmSOd0IthUQyOzaINkT/mcpClaude Desktop
Follow the steps below to connect in seconds.
- 1In Claude Desktop, open Settings → Connectors.
- 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
- 3Click Add and start a new chat — OneNote capabilities are ready to use.
{
"mcpServers": {
"onenote-mcp": {
"url": "https://edge.vinkius.com/vk_preview_v0VuD1Lg72idPZ9fSLCb2mmSOd0IthUQyOzaINkT/mcp"
}
}
}
Claude
ChatGPT
Cursor
VS Code
Windsurf
Claude Code
JetBrains
Cline
Step-by-step instructions for each client are in the guide. How to connect
FAQ
Questions OneNote owners ask.
- 01
Can the integration delete entire extensive notebooks or important local sections?
No. The integration exclusively binds heavily to Reading methods (list, search, get) mapped safely alongside minimal Write interactions specifically scoped to Appending fresh notes. Destructive end-points are intrinsically restricted protecting vital long-term data persistently.
- 02
Does it parse images contained inside OneNote native pages automatically?
Currently, fetching Page contents operates exclusively translating returned DOM hierarchies returning raw string-based text bounds flawlessly. Purely visual bitmaps or native handwritten encodings skip the explicit parsing stream avoiding LLM hallucinations fundamentally.
- 03
Why does OneNote demand a generic Graph Access Token explicitly here?
Microsoft explicitly deprecated discrete independent silo APIs unifying all native core tenant structures explicitly over the single Microsoft Graph perimeter gateway. OneNote resources are canonically navigated traversing this exact Graph endpoint hierarchy natively.
Explore
More in Industry Titans
Assembly AI Connector
Manage Assembly clients, companies, workspaces, and notes.
ViewIdeanote AI Connector
Manage ideas, missions, and innovation workspaces via Ideanote API.
ViewReadMe AI Connector
Equip your AI to directly search, read, and manage developer documentation stored in your ReadMe project.
ViewDocument360 AI Connector
Manage knowledge bases via Document360 — list project versions, handle categories and articles, search content
View
Suggestions
Interact Software AI Connector
Manage intranet people, content, and groups via Interact Software API.
ViewChartHop AI Connector
Manage people operations and organizational data via ChartHop — track jobs, people, and headcount planning dir
ViewNamely AI Connector
Manage HRIS data via Namely — track employee profiles, job info, and organization groups directly from your AI
ViewCORE (Open Access Research) AI Connector
Access millions of open access research papers, journals, and repositories directly from your AI agent using t
View
