onenote-mcp

Локальный MCP-сервер, который позволяет Claude читать ваши записные книжки OneNote, включая картинки, которые вы в них вставляли.

Он общается с настольным приложением OneNote через его COM-интерфейс. Не требуется ни регистрация приложения в Azure, ни согласие тенанта. Никакие данные не покидают машину.

Зачем это нужно

Коннектор Microsoft 365 не поддерживает OneNote. Он отклоняет запрос с ошибкой mime type 'application/msonenote' is not allowed. Любой вызов Graph API требует регистрации приложения в Entra с правами Notes.ReadWrite.All, что в корпоративном тенанте означает запрос в ИТ-отдел. Настольный COM API не требует ни того, ни другого.

Related MCP server: notebooklm-claude-integration

Что он умеет

• Ищет по всем открытым записным книжкам, включая текст внутри вставленных скриншотов , потому что собственный индекс OneNote включает распознанный OCR-текст.

• Читает страницу как текст и выдаёт список изображений на ней.

• Возвращает эти изображения как картинки, уменьшенные так, чтобы разумно помещаться в диалоге.

Он работает только для чтения. Он не может изменять, создавать или удалять что-либо.

Требования

• Windows, с установленным настольным приложением OneNote. Приложение OneNote из Microsoft Store — это другая программа, и в нём нет COM-интерфейса.

• Python 3.11 или новее. Разрядность не важна.

Установка

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

Регистрация

.mcp.json в этой папке регистрирует сервер для этого проекта. Чтобы он был доступен везде:

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

Эта же команда работает для Claude Desktop и расширения VS Code.

Инструменты

get_page и get_page_images намеренно разделены. На странице может быть с десяток полноразмерных скриншотов, и чтение её текста не должно перетаскивать их все в диалог.

Запрашивайте у get_page параметр include_ocr, когда нужен текст, который OneNote распознал внутри изображения. Часто этого достаточно, чтобы ответить на вопрос, вообще не загружая картинку.

Первый вызов медленный

Сервер не обращается к OneNote до первого вызова инструмента. Этот вызов запускает OneNote, если он закрыт, а это может занять время. Последующие вызовы быстрые: раздел на десять страниц считывается примерно за две секунды.

Разработка

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

Прочтите CLAUDE.md перед изменением com.py. В COM-интерфейсе есть две ловушки, на поиск которых уходит день, и одна из ловушек убивает процесс OneNote.