Skip to main content
Glama

onenote-mcp

Un servidor MCP local que permite a Claude leer tus blocs de notas de OneNote, incluidas las imágenes que has pegado en ellos.

Se comunica con la aplicación de escritorio de OneNote mediante su interfaz COM. No hay registro de aplicación en Azure ni consentimiento de inquilino. Nada sale del equipo.

Por qué existe

El conector de Microsoft 365 no admite OneNote. Lo rechaza con mime type 'application/msonenote' is not allowed. Cada ruta de Graph API requiere un registro de aplicación de Entra con Notes.ReadWrite.All, lo cual en un inquilino corporativo supone una solicitud al departamento de TI. La API COM de escritorio no requiere nada de esto.

Related MCP server: notebooklm-claude-integration

Qué puede hacer

  • Buscar en todos los blocs de notas abiertos, incluido el texto dentro de capturas de pantalla pegadas, porque el índice propio de OneNote cubre el OCR.

  • Leer una página como texto, con una lista de las imágenes que contiene.

  • Devolver esas imágenes como imágenes, reducidas para que quepan razonablemente en una transcripción.

Es de solo lectura. No puede modificar, crear ni eliminar nada.

Requisitos

  • Windows, con la aplicación de escritorio de OneNote instalada. La aplicación de OneNote de Microsoft Store es un programa distinto y no tiene interfaz COM.

  • Python 3.11 o posterior. No importa si es de 32 o 64 bits.

Instalación

python -m venv .venv
.venv\Scripts\python.exe -m pip install -e .

Registro

.mcp.json en esta carpeta registra el servidor para este proyecto. Para usarlo en todos lados:

claude mcp add onenote -s user -- C:\path\to\onenote_COM_mcp\.venv\Scripts\python.exe -m onenote_mcp.server

El mismo comando funciona para Claude Desktop y la extensión de VS Code.

Herramientas

Herramienta

Qué te proporciona

list_notebooks

Blocs de notas abiertos y sus secciones, e indica si cada bloc es personal o de un sitio de equipo compartido

list_pages

Las páginas de un bloc de notas, un grupo de secciones o una sección

search_pages

Páginas que coinciden con una consulta, en todo o bajo un ámbito concreto

get_page

Una página como texto, más un manifiesto de sus imágenes. Sin píxeles

get_page_images

Las imágenes, por índice, reducidas a max_edge

get_page y get_page_images están deliberadamente separadas. Una página puede contener docenas de capturas de pantalla a tamaño completo, y leer su texto no debería arrastrar todas ellas a la conversación.

Pide include_ocr en get_page cuando quieras el texto que OneNote ha reconocido dentro de una imagen. A menudo es suficiente para responder una pregunta sin necesidad de recuperar la imagen.

La primera llamada es lenta

El servidor no contacta con OneNote hasta la primera llamada a una herramienta. Esa llamada inicia OneNote si está cerrado, lo que puede tardar un rato. Las llamadas siguientes son rápidas: una sección de diez páginas se lee en unos dos segundos.

Desarrollo

.venv\Scripts\python.exe -m pytest        # no OneNote needed
.venv\Scripts\python.exe tools\smoke.py   # live check, needs OneNote

Lee CLAUDE.md antes de modificar com.py. La interfaz COM tiene dos trampas que cuestan un día encontrarlas, y una de ellas mata el proceso de OneNote.

A
license - permissive license
Not graded
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • F
    license
    A
    quality
    D
    maintenance
    Enables Claude to read and write to local Microsoft OneNote notebooks by parsing backup files and utilizing the OneNote COM API. It allows for searching notes, creating pages, and appending content without requiring Azure registration or API keys.
    10
    3

View all related MCP servers

Related MCP Connectors

  • Connect Claude to Fathom meeting recordings, transcripts, and summaries

  • Read and write your Fresh Jots notes from Claude, Cursor, and any MCP client.

  • Search, read, and write your Apple Notes from ChatGPT/Claude via a local Mac agent + MCP relay.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ChristianCruger/onenote-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server