OneNote MCP Server

@danosb

Basic information

About OneNote MCP Server

MCP server for MIcsoft OneNote

OneNote MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "onenote": {
      "command": "node",
      "args": [
        "/absolute/path/to/your/onenote-mcp.mjs"
      ],
      "env": {}
    }
  }
}

OneNote MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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

Frequently asked questions

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.

Comments

More Other MCP servers

The Living Bread

A free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

Arsen MCP

Arsen Security

Run advanced phishing, voice phishing, deepfake fraud simulations, and cybersecurity awareness training from your AI assistant.