OneNote MCP for Windows

A standalone Model Context Protocol server for Microsoft OneNote desktop. It connects directly to OneNote through its Windows COM API and does not require PeriCode, an API key, or an embedded AI provider.

Requirements

• Windows
• Microsoft OneNote desktop from Office, with at least one notebook open
• Bun 1.2 or newer

Install and connect

git clone https://github.com/eddyficial/onenote-mcp-windows.git
cd onenote-mcp-windows
bun install
bun run setup

bun run setup safely configures Codex, Claude Desktop, and Claude Code while preserving unrelated MCP entries. Preview with bun run setup --dry-run, or target one client with bun run setup --client codex, claude-desktop, or claude-code. Use --client claude for both Claude clients.

Run the server directly with:

bun run start

Capabilities

The server exposes 27 onenote_* tools covering hierarchy, page CRUD, search, organization, rich content, export, safe deletion, knowledge digests, action and decision extraction, duplicate and stale-page health checks, weekly review source packs, and preview-first templates.

Cloud notebooks caveat

onenote_create_notebook without a path lets OneNote choose its default location, which on modern installs is OneDrive cloud. A just-created cloud notebook can reject immediate writes with COM error 0x80042030 until it syncs. For reliable scripted workflows, pass an absolute local path (e.g. C:\Users\you\Documents\Notebooks) — local notebooks accept section and page writes instantly.

Safety

• Template creation previews by default.
• Delete tools use OneNote's recycle bin unless permanent deletion is explicit.
• Client setup refuses to replace a different Claude Code server named onenote.
• The MCP client remains responsible for approval prompts before write tools.

Test

bun run check
bun test

Other implementations

Same 27 tools, same schemas — pick your runtime:

• onenote-mcp-dotnet — C#/.NET, direct COM (no bridge), ships a self-contained exe (easiest install)
• onenote-mcp-python — Python + uv, same PowerShell bridge

License

MIT