azure-onenote MCP Server

Use This MCP server To

List and manage OneNote notebooks programmatically Create, update, and delete OneNote sections and pages Search OneNote pages across multiple notebooks Integrate OneNote content into AI-driven workflows Enable AI models to read and write OneNote page content Automate note-taking and content organization in OneNote

README

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

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

# 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

azure-onenote-mcp-server FAQ

How do I install the azure-onenote-mcp-server?

Installation instructions are typically provided in the repository README or npm package page; it involves npm installation and configuration with Microsoft OneNote credentials.

What authentication is required to use this MCP server?

It requires Microsoft OneNote API authentication, usually via OAuth, to securely access user notebooks and content.

Can this server create new OneNote pages with custom content?

Yes, it supports creating new pages with HTML content in specified sections.

Is it possible to search across all OneNote notebooks using this server?

Yes, the server provides functionality to search pages across multiple notebooks.

How does this server handle updates to existing OneNote pages?

It allows updating page content, enabling AI models to modify notes dynamically.

Can I delete notebooks, sections, or pages through this MCP server?

Yes, it supports deletion of notebooks, sections, and pages via its API.

Which LLM providers can integrate with this MCP server?

It is provider-agnostic and can integrate with OpenAI, Anthropic Claude, Google Gemini, and other LLMs supporting MCP.

Does this server support real-time synchronization with OneNote?

While it provides API access for CRUD operations, real-time sync depends on the client implementation using this server.