onenote

This MCP server exposes OneNote integration via Claude Desktop, allowing natural language queries to access and manipulate your OneNote knowledge base. After configuring Claude Desktop to launch the server with uv, you’ll be able to list notebooks, sections, and pages, read page content, and perform queries such as “Show me sections in my Work notebook” or “What pages are in my Ideas section?” The server authenticates against Microsoft Graph using a two-step device flow, caching tokens by default to streamline subsequent sessions. Use Claude’s OneNote tools in the toolbar to execute these actions and interact with your notebooks through natural language prompts.

Prerequisites:

• Python 3.10+ installed on your system
• uv package manager installed (recommended) or alternative Python runner
• Claude Desktop installed
• Microsoft Azure account for app registration (to obtain AZURE_CLIENT_ID)

1. Install uv (if not already installed)

• macOS/Linux: curl -LsSf https://astral.sh/uv/install.sh | sh
• or with Homebrew: brew install uv

2. Clone the repository and set up git clone https://github.com/yourusername/onenote-mcp-server.git cd onenote-mcp-server

3. Install dependencies via uv Sync (or set up a virtual environment and install with pip) uv sync

4. Register Azure App (for Graph API access)

• Create a new Azure AD application and note the Application (client) ID
• Add required Microsoft Graph permissions: Notes.Read, Notes.ReadWrite, User.Read
• Grant admin consent for the app

5. Configure Claude Desktop to point to the MCP server

• Use uv with the project path and point to onenote_mcp_server.py, e.g.: { "mcpServers": { "onenote": { "command": "uv", "args": [ "--directory", "/FULL/PATH/TO/onenote-mcp-server", "run", "python", "onenote_mcp_server.py" ], "env": { "AZURE_CLIENT_ID": "your-azure-client-id-here" } } } }

6. Restart Claude Desktop and verify the OneNote tools appear in the 🔨 menu

Tips and notes:

• Replace /FULL/PATH/TO/onenote-mcp-server with the absolute path to the project when configuring Claude Desktop.
• The first-time authentication will prompt you to authenticate via your browser; ensure you use a compatible browser (Firefox/Chrome/Edge recommended).
• Token caching is enabled by default via ONENOTE_CACHE_TOKENS; set ONENOTE_CACHE_TOKENS=false to disable persistence.
• If you encounter “No tools available” or “Command not found” errors, ensure uv is installed and in PATH, or switch to python with the full interpreter path in the config.
• For troubleshooting, verify that the Azure app has the required Graph permissions and that the redirect/callback settings align with the device flow flow used by Claude Desktop.