How do I connect my OneNote to my AI client?

You connect the MCP through Vinkius and provide a Microsoft Graph Access Token. Once connected, your AI client can immediately use the capabilities.

Can the AI see all my notebooks?

Yes, once you provide the appropriate Microsoft Graph permissions, the agent can list and search through all your available notebooks.

Does this work with Claude or Cursor?

Yes, this MCP works with any MCP-compatible client, including Claude, Cursor, and Windsurf.

Can I write new notes using the AI?

Yes, you can instruct your agent to append text or summaries directly into your existing OneNote sections.

The MCP uses Microsoft Graph Access Tokens to interact with your data through official Microsoft channels.

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.

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.

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.

An astronaut overseeing a futuristic data hub

Download PDF Markdown Version

Connect OneNote to ChatGPT, Claude and Gemini

Set it up once and it works in ChatGPT, Claude, Cursor, and any other client you love. It all runs safely in the background, so you can relax and focus on what really matters. Turn your notebooks into a searchable, actionable knowledge base.

Ask AI about this Connector

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.

Your AI does the work. We keep it safe and sound.

No other AI tool gives you this. Your workflow runs in the client you already love, your account stays protected, and you decide what the agent can and cannot do. It is the whole reason to make the switch.

Each Connector lives inside our infrastructure, the same place where your workflow runs. The three things below are already part of it, working quietly in the background so you never have to think about them. Nothing to add, nothing to set up, nothing to worry about.

V8 Isolate01

Each Connector runs inside its own sealed environment.

Each Connector runs inside its own sealed V8 runtime — no access to your files, your system, or other servers. A Connector never sees past its own request.

Kill Switch02

One switch stops every agent. Instantly.

One action deactivates every Connector, revokes every token, and ends every session at once. AI Governance keeps the record.

FinOps per User03

Spending limits that pause instead of surprise.

Every user keeps their own connections and credentials, isolated from everyone else. Anything that would cross your spending limit is held for your approval, not billed.

Three controls, built into the layer your AI connects through.

Curated set · 7 capabilities

We ship only the actions that matter.

Capability set01 / 02

01-04

4 capabilities in this set.

Part of 7 available through OneNote.

01
List notebooks
This capability lists all your Microsoft OneNote notebooks to establish the top-level structure.
02
List pages
This capability pulls page metadata like titles and IDs from a specific section without loading heavy content.
03
List sections
This capability retrieves all sections within a specific notebook to help your agent navigate folders.
04
Search pages
This capability performs a global search for keywords across every notebook in your account.

Capability set02 / 02

05-07

3 capabilities in this set.

Part of 7 available through OneNote.

05
Get notebook
This capability fetches detailed properties and configurations for a specific notebook.
06
Get page content
This capability extracts the actual raw text and HTML content from a specific OneNote page.
07
List section groups
This capability accesses section groups for navigating complex, multi-layered notebook hierarchies.

Real work

What teams actually run

Meeting Note Retrieval

Ask your agent to find specific decisions made in a meeting last week without opening OneNote.

Knowledge Base Querying

Use your agent to search through thousands of pages for a specific technical requirement.

Automated Note Taking

Have your agent append a summary of your current conversation into a designated OneNote section.

Structural Auditing

Ask your agent to list all notebooks and sections to get an overview of your organization.

Automate a task

Put OneNote to work on one thing.

Step-by-step automations your AI runs through this Connector: the workflow, the prompts to start with, and the exact capabilities behind each move.

One connector, every AI

OneNote works with the most popular AI clients.

These are the most popular clients, each with a step-by-step guide: one link, set up once, with governance and visibility built in. And because everything runs on the MCP standard, the same connection also works in any other compatible client — nothing to rebuild.

Building your own app? The connector is yours to use.

You don't need a client to put OneNote to work: the same hosted connection plugs into your own applications and agent code, with the same governance on every request. Build with it, chat with it — one connection for both.

Observed, not estimated

883ms average. Fast in production.

OneNote is checked daily against the live service.

Daily averagePeak 993ms

Oct 3Today

Fastest day: 790ms
Slowest day: 993ms
14-day trend: Stable+1%

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.

Connector linkhttps://edge.vinkius.com/vk_preview_v0VuD1Lg72idPZ9fSLCb2mmSOd0IthUQyOzaINkT/mcp

Claude 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.

Configuration · claude_desktop_config.jsonCopy

{
  "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

Guided setup for Claude? Set up OneNote in Claude and other AIs

See all the AI clients this connector works with ↑

Who it's for

Built for the work OneNote owners hand off.

Professionals who use OneNote as their primary knowledge repository and want to interact with that data via AI.

01
Project Managers
They pull meeting notes from deep archives to validate project updates.
02
Researchers
They use the AI to find obscurely filed citations in large knowledge bases.
03
Executive Assistants
They send AI-generated summaries directly into executive planners.

FAQ

Questions OneNote owners ask.

01
How do I connect my OneNote to my AI client?
You connect the MCP through Vinkius and provide a Microsoft Graph Access Token. Once connected, your AI client can immediately use the capabilities.
02
Can the AI see all my notebooks?
Yes, once you provide the appropriate Microsoft Graph permissions, the agent can list and search through all your available notebooks.
03
Does this work with Claude or Cursor?
Yes, this MCP works with any MCP-compatible client, including Claude, Cursor, and Windsurf.
04
Can I write new notes using the AI?
Yes, you can instruct your agent to append text or summaries directly into your existing OneNote sections.
05
Is my data secure?
The MCP uses Microsoft Graph Access Tokens to interact with your data through official Microsoft channels.
06
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.
07
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.
08
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

Connect OneNote to Claude, Cursor, ChatGPT & more

Your AI does the work. We keep it safe and sound.

Each Connector runs inside its own sealed environment.

One switch stops every agent. Instantly.

Spending limits that pause instead of surprise.

We ship only the actions that matter.

01-04

List notebooks

List pages

List sections

Search pages

05-07

Get notebook

Get page content

List section groups

What teams actually run

Meeting Note Retrieval

Knowledge Base Querying

Automated Note Taking

Structural Auditing

Building your own app? The connector is yours to use.

OneNote Connector

Claude Desktop

Project Managers

Researchers

Executive Assistants

How do I connect my OneNote to my AI client?

Can the AI see all my notebooks?

Does this work with Claude or Cursor?

Can I write new notes using the AI?

Is my data secure?

Can the integration delete entire extensive notebooks or important local sections?

Does it parse images contained inside OneNote native pages automatically?

Why does OneNote demand a generic Graph Access Token explicitly here?

Mem AI (Knowledge Workspace) AI Connector

Zoho Notebook AI Connector

Wolai AI Connector

KnowledgeOwl AI Connector

Suggestions

Contentful AI Connector

Document360 AI Connector

Contentstack AI Connector

ContentStack (Management) AI Connector