OneNote Retrieval — LM Studio Plugin

A native LM Studio tools-provider plugin that wraps local-onenote-mcp and defeats LM Studio's MCP result truncation. It exposes the full OneNote command surface — discovery, reading, creation, structural edits, and app control — as native plugin tools, with retrieval results returned in model-controlled pages so nothing is silently cut off.

Credits: the underlying OneNote COM server, local-onenote-mcp, is created and maintained by Peteroooooooo — https://github.com/Peteroooooooo/local-onenote-mcp. This plugin is only a thin LM Studio wrapper around that server.

Why this exists

When local-onenote-mcp is used as a normal MCP server, LM Studio truncates large tool results (long pages, big hierarchies, raw XML) and there is no setting to turn that off. This plugin exposes the same operations as native plugin tools and returns every large retrieval result in explicit, model-controlled pages:

• Text / XML tools take offset + max_chars and return next_offset / has_more.
• List / search tools take + and return / .

Internally the plugin asks the underlying server for the full document (a very large max_chars, so the server never truncates first), caches it, and hands it back to the model one small, complete slice at a time. The model keeps calling with the returned next_offset until has_more is false — so it can read an entire page or list without anything being silently cut off.

Tools provided

This plugin wraps every local-onenote-mcp command, plus one convenience command (onenote_save_all_notebook_pages_xml_to_file).

Discovery & reading (retrieval — paginated)

Tool	Purpose	Paging
onenote_health_check	Verify OneNote connection + counts	—
onenote_resolve_identifier	Resolve GUID / path / name to one object	—
onenote_get_special_locations	Backup / unfiled / default notebook folder	—
onenote_list_notebooks	List notebooks	offset/limit
onenote_list_sections	List sections (optionally in one notebook)	offset/limit
onenote_list_pages	List pages in a section	offset/limit
onenote_list_hierarchy	List hierarchy from a start point	offset/limit
onenote_get_page	Page text (+ title/objects on first slice)	offset/max_chars
onenote_get_page_text	Page plain text

Creation & structural edits (write)

Tool	Purpose
onenote_open_hierarchy	Open or create a notebook / section group / section by path
onenote_create_notebook	Create and open a local notebook
onenote_create_section	Create a section under a notebook / section group
onenote_create_section_group	Create a section group
onenote_create_page	Create a page (plain / html / markdown)
onenote_update_page_title	Rename a page
onenote_append_to_page	Append an outline block to a page
onenote_add_image_to_page	Add a local image to a page
onenote_replace_page_body	Replace a page's body content (destructive)
onenote_delete_page_content	Delete one content object by id (destructive)
onenote_delete_hierarchy	Delete a notebook / group / section / page (destructive)
onenote_update_page_xml	Advanced: submit raw page XML
onenote_update_hierarchy_xml	Advanced: submit raw hierarchy XML

File & app control

Tool	Purpose
onenote_publish_object	Export a notebook / section / page to PDF, Word, XPS, HTML, etc.
onenote_navigate_to	Focus an object in the OneNote UI
onenote_navigate_to_url	Open a onenote: URL
onenote_sync_hierarchy	Sync a notebook hierarchy object
onenote_close_notebook	Close a notebook
onenote_merge_sections	Merge one section into another (destructive)
onenote_set_filing_location	Set filing location for email / clips / printouts

Convenience

Tool	Purpose
onenote_save_all_notebook_pages_xml_to_file	Read a whole notebook by name and write every page's XML to <notebook name>.xml, preserving the section-group / section / page structure

Note: the write, structural, and app-control tools can create, modify, delete, and export your OneNote content. Enable the plugin only in chats where you want the model to have that access.

---

Prerequisites

---

Install

From this folder (lm-studio-plugin):

1. Install dependencies (creates package-lock.json)

LM Studio installs a plugin's dependencies from package.json and package-lock.json, so this file must exist. (Running npm install here has already created it.)

2. Run the plugin in development mode

The plugin now appears in LM Studio's Program → Plugins list and hot-reloads when you edit the source. Keep this terminal open while developing. Once you are happy with it, you can register it permanently with lms push (see Publishing below) — after that LM Studio runs it automatically and you no longer need lms dev.

3. Configure the plugin (only if you are NOT using the global launcher)

Open the plugin's settings in LM Studio (gear icon next to the plugin). Defaults work if local-onenote-mcp is on your PATH. To run the server directly from the Python venv instead, set:

• OneNote MCP command → full path to python.exe, e.g. C:\Data\AI\MCP\local-onenote-mcp\.venv\Scripts\python.exe
• OneNote MCP arguments → two rows: -m and local_onenote_mcp.server

Other settings (all optional):

Setting	Default	Meaning
OneNote operation timeout (s)	90	LOCAL_ONENOTE_MCP_TIMEOUT for the server
Tool request timeout (ms)	120000	Max wait for one underlying call
Underlying max characters	5,000,000	max_chars sent so the server never truncates
Default page size (characters)	8000	Text/XML chars per call when max_chars omitted
Default item page size	50	List items per call when limit omitted

Keep Default page size comfortably under LM Studio's tool-result limit. If you still see truncation, lower it (e.g. 4000) — the model just makes more calls.

4. Use it in a chat

• In a chat, enable the OneNote Retrieval plugin (tools toggle / plugin selector).
• To avoid duplicate/confusing tools, disable the raw local-onenote-mcp MCP server for chats where you use this plugin (or keep it only for write operations).
• Ask the model to read OneNote. It will page through content automatically, e.g.:

  "Read the full 'Project Launch Checklist' page from my Personal notebook."

---

How the model should page (behavioural note)

Each large result includes has_more and next_offset. The model should:

• call again with offset = next_offset until has_more is false (text/XML), and
• call again with offset = next_offset for the next batch of list items.

The plugin caches the full document after the first call, so paging is fast and does not re-hit OneNote for each slice.

---

Exporting a whole notebook to XML

onenote_save_all_notebook_pages_xml_to_file reads an entire notebook and writes one XML file that mirrors its structure — <notebook> → <sectionGroup> → <section> → <page>, with each page's raw OneNote XML embedded inline. The file is named after the notebook (e.g. Personal.xml).

Example ask:

"Save all pages of my 'Personal' notebook to XML."

---

Publishing (optional)

To register the plugin so it is always available (no lms dev needed):

Edit manifest.json (name, owner) before pushing if you want a different identity. name must be kebab-case.

---

Troubleshooting

Project layout

Credits & license

• local-onenote-mcp — the OneNote COM server this plugin wraps — is created and maintained by Peteroooooooo: https://github.com/Peteroooooooo/local-onenote-mcp. All OneNote functionality comes from that project; this plugin only adapts it to LM Studio's plugin API and adds pagination plus the notebook-to-XML export convenience command.
• This wrapper plugin is provided under the MIT license (see package.json). Refer to the upstream repository for its own license terms.