OneNote Integration
Complete OneNote MCP Server for Claude Desktop - Access your entire OneNote knowledge base through AI with robust authentication and full API support
What is OneNote Integration?
OneNote Integration is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to complete onenote mcp server for claude desktop - access your entire onenote knowledge base through ai with robust authentication and full api support
Complete OneNote MCP Server for Claude Desktop - Access your entire OneNote knowledge base through AI with robust authentication and full API support
This server falls under the Knowledge & Memory category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Complete OneNote MCP Server for Claude Desktop - Access your
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx onenoteConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use OneNote Integration
The OneNote MCP Server gives Claude Desktop (and other MCP clients) authenticated read access to your entire Microsoft OneNote knowledge base via the Microsoft Graph API. It implements OAuth device-flow authentication so you do not need to expose a callback URL, and it optionally caches tokens between sessions. Once connected, you can list notebooks, browse sections, read page content, and run natural-language queries across your notes — effectively turning OneNote into a searchable knowledge base you can converse with.
Prerequisites
- Python 3.10 or later and uv package manager (brew install uv or curl -LsSf https://astral.sh/uv/install.sh | sh)
- A Microsoft account with OneNote content (personal, Microsoft 365, or school/work account)
- An Azure app registration with the Notes.Read (or Notes.Read.All) Microsoft Graph permission and public client / device-flow enabled
- The Azure app's Client ID (AZURE_CLIENT_ID)
- An MCP client such as Claude Desktop
Register an Azure app for Microsoft Graph access
In the Azure Portal, create a new App Registration. Under 'Authentication', enable 'Allow public client flows'. Under 'API permissions', add Microsoft Graph > Delegated > Notes.Read. Copy the Application (client) ID.
Clone the repository
Download the server source.
git clone https://github.com/purpleslurple/onenote-mcp-server.git && cd onenote-mcp-serverInstall dependencies with uv
uv reads the project lockfile and installs all required packages.
uv syncAdd the server to Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) and add the mcpServers entry shown below, replacing the directory path and client ID with your values.
Authenticate on first run
On the first request, the server will print a device code URL in the Claude Desktop logs. Open that URL in a browser, sign in with your Microsoft account, and enter the code. The token is cached for subsequent sessions.
OneNote Integration Examples
Client configuration
Add this to claude_desktop_config.json. Use the full absolute path to the cloned directory. AZURE_CLIENT_ID is the only required credential.
{
"mcpServers": {
"onenote": {
"command": "uv",
"args": [
"--directory",
"/full/path/to/onenote-mcp-server",
"run",
"python",
"onenote_mcp_server.py"
],
"env": {
"AZURE_CLIENT_ID": "your-azure-app-client-id",
"ONENOTE_CACHE_TOKENS": "true"
}
}
}
}Prompts to try
Natural language queries you can use once the server is authenticated.
- "List all my OneNote notebooks"
- "Show me the sections in my Work notebook"
- "Read the content of the page called 'Project Plan'"
- "Search my notes for anything about the Q4 budget"
- "Summarise all the action items from my Meeting Notes section"Troubleshooting OneNote Integration
Device-flow authentication URL never appears or authentication times out
Check the Claude Desktop logs (Help > Show Logs). The device code URL is printed to stderr. Ensure 'Allow public client flows' is enabled in your Azure app's Authentication settings, and that the Notes.Read permission has been granted (not just added).
AZURE_CLIENT_ID not found or server crashes on startup
Confirm the env block in claude_desktop_config.json contains AZURE_CLIENT_ID with the correct value. The variable name is case-sensitive. Use the Application (client) ID from Azure Portal, not the tenant ID.
Notebooks or pages return empty results
Ensure the Microsoft account used during device-flow login is the same account that owns the OneNote content. Work/school accounts may need Notes.Read.All permission if notebooks are shared.
Frequently Asked Questions about OneNote Integration
What is OneNote Integration?
OneNote Integration is a Model Context Protocol (MCP) server that complete onenote mcp server for claude desktop - access your entire onenote knowledge base through ai with robust authentication and full api support It connects AI assistants to external tools and data sources through a standardized interface.
How do I install OneNote Integration?
Follow the installation instructions on the OneNote Integration GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with OneNote Integration?
OneNote Integration works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is OneNote Integration free to use?
Yes, OneNote Integration is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
OneNote Integration Alternatives — Similar Knowledge & Memory Servers
Looking for alternatives to OneNote Integration? Here are other popular knowledge & memory servers you can use with Claude, Cursor, and VS Code.
MemPalace
★ 52.6kA local AI memory system that stores all conversations verbatim and organizes them into navigable structures. It provides 19 MCP tools for AI assistants to search and retrieve past decisions, debugging sessions, and architecture debates automatically
Kratos
★ 25.7k🏛️ Memory System for AI Coding Tools - Never explain your codebase again. MCP server with perfect project isolation, 95.8% context accuracy, and the Four Pillars Framework.
Context Mode
★ 15.4kAn MCP server that preserves LLM context by intercepting large data outputs and returning only concise summaries or relevant sections. It enables efficient sandboxed code execution, file processing, and documentation indexing across multiple programm
Memu
★ 13.7kMemory for 24/7 proactive agents like OpenClaw.
MemOS
★ 9.3kMemOS (Memory Operating System) is a memory management operating system designed for AI applications. Its goal is: to enable your AI system to have long-term memory like a human, not only remembering what users have said but also actively invoking, u
Everos
★ 5.4kBuild, evaluate, and integrate long-term memory for self-evolving agents.
Browse More Knowledge & Memory MCP Servers
Explore all knowledge & memory servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up OneNote Integration in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use OneNote Integration?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.