onenote-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
onenote-mcp
Servidor MCP para leer, buscar y escribir en OneNote de escritorio (Windows) desde Claude Code, Claude Desktop u otro cliente MCP.
Se conecta a la app de OneNote instalada en tu PC mediante su interfaz COM:
Sin Azure ni Microsoft Graph: no hay que registrar ninguna app ni iniciar sesión en otro servicio.
Local: tus apuntes solo viajan desde OneNote hasta el cliente MCP que los pide.
Ve tus imágenes: incluye el texto reconocido (OCR) de cada captura y puede adjuntar las imágenes para que el modelo las vea.
Seguro al escribir: solo crea páginas o añade contenido al final; no hay herramientas para borrar ni sobrescribir.
Requisitos
Windows con OneNote de escritorio (el de Office: OneNote 2013, 2016, 2019, 2021 o Microsoft 365). La app "OneNote para Windows 10" de la Store no tiene interfaz COM.
Python 3.10 o superior.
Los cuadernos que quieras usar deben estar abiertos en OneNote de escritorio (Archivo → Abrir). Si están en OneDrive, se sincronizan solos.
Related MCP server: MCP OneNote Server
Instalación
git clone https://github.com/Mickaell22/onenote-mcp.git
cd onenote-mcp
python -m venv .venv
.venv\Scripts\pip install -e .Claude Code
claude mcp add onenote --scope user -- "C:\ruta\a\onenote-mcp\.venv\Scripts\onenote-mcp.exe"
claude mcp list # debería mostrar: onenote ... ✔ ConnectedClaude Desktop u otros clientes
{
"mcpServers": {
"onenote": {
"command": "C:\\ruta\\a\\onenote-mcp\\.venv\\Scripts\\onenote-mcp.exe"
}
}
}Herramientas
Herramienta | Qué hace |
| Árbol de cuadernos, grupos, secciones y páginas (sin la papelera). |
| Páginas modificadas en los últimos N días. |
| Busca palabras en todas las páginas, incluido el OCR de las imágenes. Sin distinguir mayúsculas ni tildes, con fragmentos de contexto. Se puede limitar a un cuaderno o sección. |
| Página en Markdown: títulos, listas, casillas |
| Devuelve imágenes concretas de una página por su número. |
| Crea una página en una sección a partir de Markdown. |
| Añade Markdown al final de una página sin tocar lo que ya tiene. |
| Pide a OneNote que sincronice con la nube (para apuntes hechos en el móvil o en la web). |
| Muestra una página o sección en la ventana de OneNote. |
Las páginas, secciones y cuadernos se pueden indicar por nombre ("Clase 3"), por ruta parcial ("Redes / Clase 3") o por ID. Si un nombre es ambiguo, la herramienta lista las opciones.
Markdown admitido al escribir
# Títulos (1–6), - viñetas, 1. numeradas, - [ ] tareas / - [x] hechas, **negrita**, *cursiva*, ~~tachado~~, `código`, bloques ```, [enlaces](https://…), tablas | a | b | y sangría de 2 espacios para anidar.
Ejemplos de uso
"¿Qué apunté esta semana en OneNote?"
"Busca en mis apuntes dónde hablé de subneteo y explícamelo."
"Lee la página «Clase 5» y mira las capturas: ¿qué error sale en la segunda?"
"Crea en la sección Redes una página «Resumen parcial» con los puntos clave de las clases 1 a 5."
"Añade a «Pendientes» una tarea: revisar el informe."
Detalles técnicos
Type library mal registrada: en muchas instalaciones de Office de 64 bits la type library de OneNote solo está registrada para Win32, y
pywin32falla con "Biblioteca no registrada". Este servidor la carga directamente desdeONENOTE.EXEconcomtypes, que llama por vtable.Un solo hilo COM: todas las llamadas a OneNote pasan por un hilo dedicado; si OneNote se cierra, la siguiente llamada reconecta.
Imágenes de cuadernos en la nube: OneNote no las descarga hasta que se abre la página. Si una imagen aún no está en el equipo, el servidor abre esa página un momento, espera la descarga y vuelve a la página que tenías abierta.
Añadir contenido: enviar a OneNote un bloque existente (con su
objectID) hace que lo reemplace entero. Por esoagregar_a_paginacrea un bloque nuevo colocado debajo de todo lo que ya hay.Búsqueda: no depende del indexado de Windows. Mantiene en memoria el texto de cada página (y su OCR) y solo vuelve a leer las que cambiaron.
Desarrollo
.venv\Scripts\pip install -e ".[dev]"
.venv\Scripts\python -m pytestLas pruebas usan XML de ejemplo y no necesitan OneNote.
Licencia
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Persistent memory layer for AI tools. Save and recall notes across Claude and other MCP clients.
Notes and memory assistant: one Markdown vault that Claude, ChatGPT and any MCP client can share.
MCP-native notes and memory for ChatGPT, Claude, and other AI tools.
Read and write your Fresh Jots notes from Claude, Cursor, and any MCP client.
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-
- FlicenseAqualityDmaintenanceEnables AI agents to read, create, and analyze Microsoft OneNote notebooks, sections, and pages, including automatic image text extraction via Claude Vision.71-
- AlicenseNot gradedqualityCmaintenanceEnables Claude to read local OneNote notebooks via the Windows desktop COM API, including text from pasted screenshots, while keeping all data on the machine.MIT
- AlicenseNot gradedqualityBmaintenanceGives 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