OneNoteMCP

Forked from [ZubeidHendricks/azure-onenote-mcp-server](https://github.com/ZubeidHendricks/azure-onenote-mcp-server) see that page for the original README.md ## About An MCP for OneNote. Forked and revised extensively, now works with personal notebooks. Updated to the latest MCP API. Supports caching credentials. ## Improvements ### Functionality - Fixed `getPageContent` functionality by implementing ReadableStream - Successfully implemented API calls against personal notebooks - Updated index and tools to use the latest MCP version ### Code Architecture - Simplified codebase by removing classes that weren't necessary - Many unnecessary files removed ### Authentication & Performance - Implemented disk caching for authentication credentials - Updated package dependencies - Added dotenv support for direct testing capabilities ## Azure App Registration 1. Go to Azure Portal and navigate to App registrations 2. Create a new registration for OneNoteMCP 3. Add Microsoft Graph API permissions: - Notes.Read - Notes.Read.All - (optionally add Notes.Write permissions, but there is a risk of losing your notes) 4. Create a client secret 5. Copy the client ID/secret for configuration 6. In the manifest set `signInAudience` to `AzureADandPersonalMicrosoftAccount` ## MCP Server setup Put the client ID/secret n your `.env` file locally as well as in Claude desktop. The `AUTH_CACHE_DIR` should be the directory where you want the generated API access token to be stored. ``` AZURE_CLIENT_ID=\ AZURE_CLIENT_SECRET= AUTH_CACHE_DIR="C:\\git\\azure-onenote-mcp-server\\.cache" ``` Run server manually first to generate the credentials that will be cached and used by Claude desktop when it runs the server later on. ``` npm install npm build npm run ``` You can test the API works by running this command directly once the server starts up and logs in. `{"jsonrpc": "2.0", "id": 3, "method": "tools/call", "params": {"name": "listNotebooks", "arguments": {}}}` ## Claude MCP config ``` { "mcpServers": { "onenote": { "command": "node", "args": ["C:\\git\\azure-onenote-mcp-server\\dist\\index.js"], "env": { "AZURE_CLIENT_ID": "...", "AZURE_CLIENT_SECRET": "...", "AUTH_CACHE_DIR": "C:\\git\\azure-onenote-mcp-server\\.cache" } } } } ```