onenote-mcp
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: MCP OneNote Server
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.serverEl mismo comando funciona para Claude Desktop y la extensión de VS Code.
Herramientas
Herramienta | Qué te proporciona |
| Blocs de notas abiertos y sus secciones, e indica si cada bloc es personal o de un sitio de equipo compartido |
| Las páginas de un bloc de notas, un grupo de secciones o una sección |
| Páginas que coinciden con una consulta, en todo o bajo un ámbito concreto |
| Una página como texto, más un manifiesto de sus imágenes. Sin píxeles |
| Las imágenes, por índice, reducidas a |
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 OneNoteLee 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.
This server cannot be deployed
Maintenance
Related MCP Connectors
Connect Claude to your Platform7n workspaces: chat, links, work and decks. One-click OAuth.
Connect ChatGPT, Claude, Cursor or VS Code to your Windows PC: files, terminal, browser, apps.
Notes, tasks, habits, journal and 6 more tools Claude can read and change, with undo. Free.
A second brain for Claude: remembers your work, plans your day, encrypted under a key only you hold.
Related MCP Servers
- FlicenseAqualityDmaintenanceEnables 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.104-
- FlicenseAqualityFmaintenanceEnables AI agents to read, create, and analyze Microsoft OneNote notebooks, sections, and pages, including automatic image text extraction via Claude Vision.71-
- AlicenseNot gradedqualityAmaintenanceGives Claude direct access to local Microsoft OneNote notebooks, enabling reading from backups and live via COM automation, plus writing sections and pages without a Microsoft account or API key.MIT
- AlicenseNot gradedqualityCmaintenanceEnables Claude to sign in with a Microsoft account and read, write, search, create, move, and organize notebooks, section groups, sections, and pages, including drawing Mermaid or SVG diagrams rendered into notes. It also fetches embedded images and page contents as Markdown so handwritten-note workflows and checkboxes can be managed conversationally.21 npmMIT