Skip to main content
Glama

onenote-mcp

Ein lokaler MCP-Server, mit dem Claude deine OneNote-Notizbücher lesen kann – einschließlich der Bilder, die du hineingefügt hast.

Er spricht mit der OneNote-Desktop-Anwendung über deren COM-Schnittstelle. Es gibt keine Azure-App-Registrierung und keine Mandantenzustimmung. Nichts verlässt den Rechner.

Warum es das gibt

Der Microsoft 365-Connector unterstützt OneNote nicht. Er lehnt Anfragen mit mime type 'application/msonenote' is not allowed ab. Jede Graph-API-Route benötigt eine Entra-App-Registrierung mit Notes.ReadWrite.All, was in einem Unternehmensmandanten eine IT-Anfrage bedeutet. Die Desktop-COM-API braucht keins von beidem.

Related MCP server: notebooklm-claude-integration

Was er kann

  • Durchsucht jedes geöffnete Notizbuch, einschließlich des Texts in eingefügten Screenshots, denn der eigene Suchindex von OneNote deckt auch OCR ab.

  • Liest eine Seite als Text, zusammen mit einer Liste der Bilder auf der Seite.

  • Gibt diese Bilder als Abbildungen zurück, verkleinert, damit sie sinnvoll in ein Transkript passen.

Er ist schreibgeschützt. Er kann nichts ändern, erstellen oder löschen.

Voraussetzungen

  • Windows mit installierter OneNote-Desktop-Anwendung. Die OneNote-App aus dem Microsoft Store ist ein anderes Programm und hat keine COM-Schnittstelle.

  • Python 3.11 oder neuer. Die Bitarchitektur (32-Bit oder 64-Bit) spielt keine Rolle.

Installieren

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

Registrieren

.mcp.json in diesem Projektordner registriert den Server für dieses Projekt. Um ihn überall zu verwenden:

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

Der gleiche Befehl funktioniert für Claude Desktop und die VS-Code-Erweiterung.

Tools

Tool

Was es dir liefert

list_notebooks

Geöffnete Notizbücher und deren Abschnitte, sowie ob jedes Notizbuch persönlich oder auf einer Teamwebsite liegt

list_pages

Die Seiten unter einem Notizbuch, einer Abschnittsgruppe oder einem Abschnitt

search_pages

Seiten, die zu einer Suche passen, bereichsübergreifend oder unter einer eingeschränkten Gültigkeitsbereich

get_page

Eine Seite als Text plus eine Auflistung ihrer enthaltenen Bilder. Keine Pixel.

get_page_images

Die Bilder, nach Index, verkleinert auf max_edge

get_page und get_page_images sind bewusst getrennt. Eine Seite kann ein Dutzend Screenshots in Originalgröße enthalten, und das Lesen ihres Texts sollte nicht alle davon ins Gespräch ziehen.

Frag get_page nach include_ocr, wenn du den Text haben möchtest, den OneNote in einem Bild erkannt hat. Das reicht oft, um eine Frage zu beantworten, ohne das Bild überhaupt abzurufen.

Der erste Aufruf ist langsam

Der Serverkontakt nimmt OneNote erst beim ersten Tool-Aufruf auf. Dieser Aufruf startet OneNote, falls es geschlossen ist, was eine Weile dauern kann. Spätere Aufrufe sind schnell: Ein Abschnitt mit zehn Seiten liest sich in etwa zwei Sekunden.

Entwicklung

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

Lies CLAUDE.md, bevor du com.py änderst. Die COM-Schnittstelle hat zwei Fallstricke, deren Entdeckung einen Tag kostet, und einer davon beendet den OneNote-Prozess.

A
license - permissive license
Not graded
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • F
    license
    A
    quality
    D
    maintenance
    Enables 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.
    10
    3

View all related MCP servers

Related MCP Connectors

  • Connect Claude to Fathom meeting recordings, transcripts, and summaries

  • Read and write your Fresh Jots notes from Claude, Cursor, and any MCP client.

  • Search, read, and write your Apple Notes from ChatGPT/Claude via a local Mac agent + MCP relay.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ChristianCruger/onenote-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server