Skip to main content
Glama
mhzarem

OneNote MCP Server

by mhzarem
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
ONENOTE_BACKUP_DIRNoThe directory where OneNote backup files (.one) are stored. By default, the server reads from the OneNote desktop app's local backup directory (C:\Users\<user>\AppData\Local\Microsoft\OneNote\16.0\Backup\).

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
list_notebooksA

List all locally available OneNote notebooks.

Shows notebook names and how many sections each one has.

list_sectionsC

List all sections in a specific notebook.

Args:
    notebook_name: The name of the notebook (from list_notebooks).
read_sectionA

Read all text content from a specific section of a notebook.

Args:
    notebook_name: The name of the notebook.
    section_name: The name of the section (from list_sections).
search_notesA

Search for text across ALL notebooks and sections.

Searches through the text content of every section for the given query.
Returns matching sections with a snippet of the matched text.

Args:
    query: The text to search for (case-insensitive).
list_all_sectionsA

List ALL sections across ALL notebooks.

Useful for getting a complete overview of everything in your OneNote.

get_notebook_summaryC

Get a summary of a notebook: its sections and a preview of each section's content.

Args:
    notebook_name: The name of the notebook.
list_live_notebooksA

List notebooks from the running OneNote app (live, not backup files).

This uses the OneNote COM API and shows the notebooks currently open in the OneNote desktop app, including their sections. Use this to find where to create new pages.

create_pageA

Create a new page in a OneNote notebook section.

The content is written as HTML. You can use basic HTML tags like
<b>, <i>, <br>, <ul>, <li>, <h1>-<h6>, etc.

Requires the OneNote desktop app to be installed.

Args:
    notebook_name: Name of the notebook (from list_live_notebooks).
    section_name: Name of the section within the notebook.
    title: Title for the new page.
    content: The page content (plain text or HTML).
list_live_pagesB

List pages in a section from the running OneNote app.

Use this to find page IDs for appending content to existing pages.

Args:
    notebook_name: Name of the notebook.
    section_name: Name of the section.
append_to_pageA

Append content to an existing OneNote page.

The content is added as a new outline block at the bottom of the page.
Supports HTML formatting (<b>, <i>, <br>, <ul>, <li>, etc.).

Args:
    page_id: The page ID (from list_live_pages).
    content: The content to append (plain text or HTML).

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A3.7/5.0

Scored across 10 tools

Disambiguation4/5

Most tools have clear, distinct purposes (e.g., create_page vs append_to_page). However, there is potential confusion between list_notebooks and list_live_notebooks, and between list_sections and list_all_sections, though descriptions clarify some differences.

Naming Consistency5/5

All tool names follow a consistent verb_noun pattern using snake_case (e.g., list_live_notebooks, create_page, search_notes). No mixing of conventions.

Tool Count5/5

With 10 tools, the set is well-scoped for a Note-taking server. It covers the main operations—listing, creating, reading, appending, and searching—without being overwhelming.

Completeness3/5

Core read (list notebooks, sections, pages, read section) and write (create page, append content) operations are present. However, missing update (edit page), delete (page, section, notebook), and create section/notebook leave notable gaps for full lifecycle management.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources