Servidor OneNote MCP

Un servidor MCP (Protocolo de Contexto de Modelo) para explorar e interactuar con la aplicación web de OneNote mediante la automatización del navegador. Este servidor permite a los asistentes de IA y otros clientes compatibles con MCP explorar e interactuar programáticamente con los blocs de notas de OneNote compartidos mediante enlaces web.

Características

Navegar por la estructura jerárquica de OneNote (cuadernos, secciones, páginas)
Leer el contenido de la página de OneNote
Añadir nuevo contenido a páginas existentes
Crear nuevas páginas
Buscar dentro de OneNote
Tomar capturas de pantalla de la vista actual
Mantener el estado durante toda la sesión

Requisitos

Python 3.10 o superior
uso del navegador 0.1.40 o superior
MCP SDK 1.2.0 o superior
Dramaturgo
Conexión a Internet
Una URL de cuaderno de OneNote compartida (debe ser accesible sin autenticación)

Instalación

# Clone the repository or create the project structure
# Then navigate to the project directory
cd onenote-mcp

# Install the package and dependencies
pip install -e .

# Install Playwright browsers
playwright install

Uso

Modo independiente

Puedes ejecutar el servidor directamente con:

python -m onenote_mcp

Integración con Claude Desktop u otros hosts MCP

Configure su Claude Desktop para utilizar el servidor OneNote MCP editando el archivo de configuración:

{
  "mcpServers": {
    "onenote": {
      "command": "python",
      "args": ["-m", "onenote_mcp"]
    }
  }
}

Inicie Claude Desktop, que iniciará automáticamente el servidor OneNote MCP
Utilice las herramientas disponibles en su chat con Claude:

Can you help me navigate my OneNote notebook at https://example.com/my-shared-notebook? 
First, please launch OneNote with this URL and tell me what notebooks are available.

Herramientas disponibles

launch_onenote(shared_url) : Inicia la aplicación web de OneNote con una URL de cuaderno compartida
get_all_notebooks() : enumera todos los cuadernos disponibles
get_all_sections() : enumera todas las secciones en el cuaderno actual
get_all_pages() : enumera todas las páginas de la sección actual
navigate_to_notebook_by_name(notebook_name) : Ir a un cuaderno específico
navigate_to_section_by_name(section_name) : Ir a una sección específica
navigate_to_page_by_name(page_name) : Ir a una página específica
get_current_page_content() : Obtener el contenido de la página actual
add_content_to_page(content) : Agrega contenido a la página actual
create_new_page_with_name(page_name) : Crea una nueva página
search_in_onenote(search_term) : busca términos específicos en OneNote
take_screenshot() : toma una captura de pantalla de la vista actual
get_onenote_state() : Obtener la información del estado actual
close_onenote() : cierra la sesión de OneNote y limpia los recursos

Cómo funciona

Este servidor MCP utiliza Browser-Use, un marco de automatización de navegadores, para interactuar con la interfaz web de OneNote. Crea un puente entre los asistentes de IA compatibles con MCP y la aplicación web de OneNote, lo que permite el control programático de las funciones de OneNote.

Limitaciones

Solo funciona con cuadernos de OneNote que se comparten con un enlace público (sin autenticación)
Es posible que el servidor necesite ajustes si cambia la interfaz web de OneNote
La automatización del navegador puede ser algo frágil y depender de la estructura de la interfaz de usuario.
El rendimiento puede variar según las condiciones de la red y la capacidad de respuesta de OneNote.

Solución de problemas

Si el servidor no puede conectarse a OneNote, asegúrese de que el enlace compartido sea accesible sin iniciar sesión
Si los selectores fallan, es posible que la interfaz de usuario de OneNote haya cambiado: verifique el código del servidor
Para otros problemas, consulte los registros del servidor para obtener detalles del error.

Licencia

Instituto Tecnológico de Massachusetts (MIT)

OneNote MCP Server