OneNote MCP Server

A Model Context Protocol (MCP) server implementation for Microsoft OneNote, enabling AI language models to interact with OneNote through a standardized interface.

Features

Notebook Management

List all notebooks
Create new notebooks
Get notebook details
Delete notebooks

Section Management

List sections in a notebook
Create new sections
Get section details
Delete sections

Page Management

List pages in a section
Create new pages with HTML content
Read page content
Update page content
Delete pages
Search pages across notebooks

Installation

Installing via Smithery

To install OneNote Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @modelcontextprotocol/server-onenote --client claude

Manual Installation

npm install -g mcp-server-onenote

Configuration

Set the following environment variables:

AZURE_TENANT_ID: Your Azure tenant ID
AZURE_CLIENT_ID: Your Azure application (client) ID
AZURE_CLIENT_SECRET: Your Azure client secret

Using with MCP Client

Add this to your MCP client configuration (e.g. Claude Desktop):

{
  "mcpServers": {
    "onenote": {
      "command": "npx",
      "args": ["-y", "mcp-server-onenote"],
      "env": {
        "AZURE_TENANT_ID": "<YOUR_TENANT_ID>",
        "AZURE_CLIENT_ID": "<YOUR_CLIENT_ID>",
        "AZURE_CLIENT_SECRET": "<YOUR_CLIENT_SECRET>"
      }
    }
  }
}

Azure App Registration

Go to Azure Portal and navigate to App registrations
Create a new registration
Add Microsoft Graph API permissions:
- Notes.ReadWrite.All
- Notes.Read.All
Create a client secret
Copy the tenant ID, client ID, and client secret for configuration

Development

# Install dependencies
npm install

# Run tests
npm test

# Build
npm run build

# Lint
npm run lint

Contributing

See CONTRIBUTING.md for information about contributing to this repository.

License

This project is licensed under the MIT License - see the LICENSE file for details