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