onenote-mcp
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: MCP OneNote Server
Что он умеет
Ищет по всем открытым записным книжкам, включая текст внутри вставленных скриншотов , потому что собственный индекс 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.
This server cannot be deployed
Maintenance
Related MCP Connectors
- platform7nOAuthtech.p7n
Connect Claude to your Platform7n workspaces: chat, links, work and decks. One-click OAuth.
- ZionDeskOAuthapp.ziondesk
Connect ChatGPT, Claude, Cursor or VS Code to your Windows PC: files, terminal, browser, apps.
A second brain for Claude: remembers your work, plans your day, encrypted under a key only you hold.
Mac & Windows: let ChatGPT, Claude & Cursor use your email, calendar, iMessage, Teams, files.
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.19 npmMIT