• STRUCTURE
  • GROUPS
  • SECTIONS
  • HUMAN

How to map OneNote hierarchy with your AI

Connect your OneNote account to give your agent a clear view of your entire notebook structure. Once connected, your AI can navigate your folders and sections to find exactly where information lives.

Ask AI about this page

Short answer

How can I see my OneNote structure through AI?

Your AI uses this MCP to pull a list of every notebook, section group, and section you own. This creates a structural map you can use to audit your organization or find misplaced notes. You'll get a full breakdown of your hierarchy below.

Mapping outcomes

Where your data lands

The AI organizes your structural data into these specific views.

STRUCTURE

Full notebook list

The AI identifies every notebook in your account. You get a high-level view of your primary storage containers.

GROUPS

Section group maps

The AI finds all section groups. This helps you see how you've nested your topics and sub-topics.

SECTIONS

Section inventory

The AI lists every individual section. You can use this to spot empty sections or redundant categories.

HUMAN

Manual cleanup

The AI only reads the structure. You still need to manually move or delete sections to fix your organization.

The workflow

What your AI does when the hierarchy request arrives.

The AI moves through your OneNote layers to build a complete picture of your data.

  1. Identify notebooks

    The agent starts by pulling a list of all available notebooks in your account.

    list_notebooks

  2. Find section groups

    It looks inside those notebooks to find any section groups you've created.

    list_section_groups

  3. List all sections

    The agent crawls through the groups to identify every specific section.

    list_sections

  4. Build the map

    The AI compiles these lists into a single coherent hierarchy for you to review.

    list_notebookslist_section_groupslist_sections

Try it

Copy these to start.

Paste these prompts into your chat to begin the audit.

Starting points

These are basic starting lines. You can swap out specific notebook names if you only want to audit one area.

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.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 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"
    }
  }
}
Copy into chat04

  • List all my OneNote notebooks and show me the hierarchy.

  • Find all the section groups in my 'Work Projects' notebook.

  • Show me a list of every section inside my 'Personal' notebook.

  • Audit my OneNote structure and tell me which notebooks have the most sections.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect OneNote once, then ask.

Click the link to connect your account. Your credentials stay encrypted, and you can immediately start asking your agent about your notes.

Connect OneNote to your AI

FAQ

How this task behaves

  • 01

    Can the AI delete my sections?

    No. This MCP only provides tools to list your notebooks, groups, and sections. It cannot modify or delete your content.

  • 02

    Can the AI read the actual text inside my notes?

    No. This specific task is limited to mapping the hierarchy. It sees the names of notebooks and sections, but not the content within them.

  • 03

    Does the AI see my passwords?

    No. Your login remains encrypted and secure. The AI only interacts with the data exposed by the tools.

  • 04

    Can I use this with Claude?

    Yes, as long as you are using an MCP-compatible client like Claude Desktop.

  • 05

    Will this work for my mobile OneNote app?

    The connection happens between your AI client and OneNote. It doesn't change how your mobile app functions.

  • More questions about OneNote? The Connector page answers them. See everything the OneNote Connector can do

Connect OneNote to Claude, Cursor, ChatGPT & more