Zubeidhendricks Azure Onenote MCP Server

🚀 Microsoft OneNote MCP Server

An implementation of the Model Context Protocol (MCP) server for Microsoft OneNote, enabling AI language models to interact with OneNote through a unified interface.

🚀 Quick Start

This server allows AI language models to interact with OneNote through a unified interface. You can manage notebooks, sections, and pages, and perform operations such as listing, creating, reading, updating, and deleting.

✨ Features

Notebook Management

• List all notebooks
• Create a new notebook
• Get detailed information about a notebook
• Delete a notebook

Section Management

• List sections in a notebook
• Create a new section
• Get detailed information about a section
• Delete a section

Page Management

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

📦 Installation

npm install -g mcp-server-onenote

📚 Documentation

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

Usage with MCP Client

Add the following 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 Application Registration

1. Visit the 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.

💻 Usage Examples

Basic Usage

# Install dependencies
npm install

# Run tests
npm test

# Build
npm run build

# Check code
npm run lint

🤝 Contributing

For contribution information, please refer to CONTRIBUTING.md.

📄 License

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