OneNote MCP Server

What is OneNote MCP Server?

A Model Context Protocol (MCP) server implementation for Microsoft OneNote, enabling AI language models to interact with OneNote notebooks, sections, and pages through a standardized interface.

How to use OneNote MCP Server?

Install globally from npm with npm install -g mcp-server-onenote, then run mcp-server-onenote or use npx mcp-server-onenote. Configure three environment variables (AZURE_TENANT_ID, AZURE_CLIENT_ID, AZURE_CLIENT_SECRET) and add the server to your MCP client configuration with the command mcp-server-onenote.

Key features of OneNote MCP Server

• List, create, get, and delete notebooks
• List, create, get, and delete sections
• List, create, read, update, and delete pages
• Create pages with HTML content
• Search pages across all notebooks

Use cases of OneNote MCP Server

• An AI assistant creates a new notebook and populates it with notes from a conversation
• A developer automates the archival of daily logs into OneNote sections
• A chatbot searches across all notebooks for a specific keyword and returns relevant pages
• A workflow tool updates existing page content based on external input

FAQ from OneNote MCP Server

What Azure permissions are required?

The Azure app registration must include Microsoft Graph API permissions Notes.ReadWrite.All and Notes.Read.All.

How do I obtain the required Azure credentials?

Go to the Azure Portal, create an App Registration, add the Graph API permissions, create a client secret, and copy the tenant ID, client ID, and client secret.

Is the package available on npm?

Yes, it is published as mcp-server-onenote on the npm registry as of April 27, 2025.

Can I run this server without an Azure account?

No, the server requires an Azure App Registration with valid credentials to authenticate against Microsoft Graph.

How is the server connected to an MCP client?

The server runs as a subprocess launched by the MCP client (e.g., Claude Desktop) via the command specified in the client configuration; no network transport is configured.