OneNote MCP

Forked from 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

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"
      }
    }
  }
}

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": {}}}