What is Azure Onenote Mcp Server

The azure-onenote-mcp-server is an implementation of the Model Context Protocol (MCP) for Microsoft OneNote, allowing AI language models to interact with OneNote through a standardized interface.

Use cases

Use cases include automating note organization, integrating AI for content generation in OneNote, and enabling collaborative features for teams using OneNote for project management.

How to use

To use the azure-onenote-mcp-server, install it via Smithery or manually using npm. Configure it by setting environment variables for Azure credentials and integrate it with your MCP client by adding the server configuration.

Key features

Key features include notebook management (listing, creating, deleting notebooks), section management (listing, creating, deleting sections), and page management (listing, creating, reading, updating, deleting pages, and searching pages across notebooks).

Where to use

The azure-onenote-mcp-server can be used in educational, corporate, and personal productivity environments where OneNote is utilized for note-taking and information management.

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 from npm (Recommended)

npm install -g mcp-server-onenote

The package is now available on the npm registry as of April 27, 2025.

Running the Package

After installation, you can run the package using:

mcp-server-onenote

Or with npx:

npx mcp-server-onenote

Installing via Smithery

To install OneNote Server for Claude Desktop automatically via Smithery:

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

Installing from GitHub

npm install -g github:ZubeidHendricks/azure-onenote-mcp-server

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

1. Go to Azure Portal and navigate to App registrations
2. Create a new registration
3. Add Microsoft Graph API permissions:
   • Notes.ReadWrite.All
   • Notes.Read.All
4. Create a client secret
5. 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

# Run locally
npm start

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

Changelog

0.1.0 (2025-04-27)

• Initial release
• Core functionality for OneNote notebook, section, and page management
• Published to npm registry

0.1.1 (2025-04-27)

• Added executable bin to package.json
• Fixed issue where npx command couldn’t determine executable to run
• Updated README with clear running instructions