OneNote MCP Server

What is OneNote MCP Server?

A Model Context Protocol (MCP) server that enables AI assistants like Claude to read, create, and search Microsoft OneNote notebooks, sections, and pages using natural language. It authenticates via Microsoft device code flow without needing Azure setup or API keys.

How to use OneNote MCP Server?

Install Node.js 16+ and Git, clone the repository, download and build the MCP TypeScript SDK, then run npm install and npm start. Configure the server in Cursor or Claude Desktop by adding a JSON entry with command "node" and the absolute path to the onenote-mcp.mjs file.

Key features of OneNote MCP Server

• Authentication via device code flow (no Azure setup)
• List all notebooks, sections, and pages
• Create new pages with HTML content
• Read complete page content with formatting
• Search across all notes
• Summarize content of all pages in one operation

Use cases of OneNote MCP Server

• Ask an AI to show and manage your OneNote notebooks without switching contexts
• Create new note pages and populate them with summaries or action items
• Search for notes related to specific topics like "project planning"
• Read and summarize entire page contents for analysis
• Extract action items from meeting notes

FAQ from OneNote MCP Server

How does authentication work?

Authentication uses Microsoft's device code flow. The AI assistant provides a URL and code; you enter the code at that URL to sign in. No Azure setup or API keys required.

What are the runtime requirements?

Node.js 16 or higher, a Microsoft account with OneNote, Git, and an MCP-compatible AI assistant (e.g., Claude Desktop, Cursor).

Where are authentication tokens stored?

Tokens are stored locally in .access-token.txt in the server directory. They expire after some time and require re-authentication.

What OneNote operations are supported?

The server provides tools to authenticate, list notebooks, get notebook details, list sections, list pages, get page content, create pages, and search pages.

Are there any known limitations?

Tokens grant access to your OneNote data and must be kept secure. Authentication may fail with older browsers or tracking prevention. "expired_token" errors require restarting the authentication process.