logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

azure-ms-onenote-mcp-gateway

Facilitate standardized interaction with Microsoft OneNote structures (notebooks, sections, pages) via a unified API layer, leveraging Azure Active Directory for secure, authenticated operations including content CRUD and search capabilities.

Author

azure-ms-onenote-mcp-gateway logo

ZubeidHendricks

No License

Quick Info

GitHub GitHub Stars 19
NPM Weekly Downloads 0
Tools 1
Last Updated 2026-02-19

Tags

onenoteazurecloudazure onenotemicrosoft onenoteonenote notebooks

OneNote MCP Access Point

smithery badge npm version Verified on MseeP

An implementation of the Model Context Protocol (MCP) server designed specifically for Microsoft OneNote, allowing AI models to perform structured data manipulation within the OneNote ecosystem via a defined interface.

Core Capabilities

Binder Organization Administration

  • Enumerate all available binders
  • Provision new binders
  • Retrieve specific binder metadata
  • Retire (remove) binders

Subsection Structure Control

  • List subsections within a specified binder
  • Establish new subsections
  • Query subsection attributes
  • Decommission subsections

Content Element Management

  • Fetch the list of content elements (pages) in a subsection
  • Inject new content elements, supporting HTML format
  • Extract existing content from a page
  • Modify the content of a page
  • Erase content elements
  • Execute cross-binder content discovery based on query parameters

Deployment

Installation via npm (Preferred Method)

bash npm install -g mcp-server-onenote

This package has been available on the npm repository since April 27, 2025.

Execution Instructions

Once installed, invoke the server instance with: bash mcp-server-onenote

Alternatively, use npx: bash npx mcp-server-onenote

Integration via Smithery

For automated setup with environments like Claude Desktop, utilize the Smithery CLI:

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

Source Code Checkout

Direct installation from the GitHub repository: bash npm install -g github:ZubeidHendricks/azure-onenote-mcp-server

Configuration Requirements

Ensure the following environmental variables are configured for authentication: - AZURE_TENANT_ID: Identifikator for your Azure organizational tenant - AZURE_CLIENT_ID: The Application (Client) ID for your registered Azure service principal - AZURE_CLIENT_SECRET: The secure credential key for the service principal

Client Integration Example (e.g., Claude Desktop)

Embed the following configuration snippet into your primary MCP client settings:

{ "mcpServers": { "onenote": { "command": "mcp-server-onenote", "env": { "AZURE_TENANT_ID": "", "AZURE_CLIENT_ID": "", "AZURE_CLIENT_SECRET": "" } } } }

Azure Application Registration Steps

  1. Navigate to the Azure Portal and access 'App registrations'.
  2. Initiate creation of a new registration.
  3. Grant the necessary Microsoft Graph API permissions:
  4. Notes.ReadWrite.All
  5. Notes.Read.All
  6. Generate and secure a client secret.
  7. Record and utilize the Tenant ID, Client ID, and the generated Client Secret for the configuration step above.

Development Workflow

bash

Install project dependencies

npm install

Execute unit and integration tests

npm test

Compile source code

npm run build

Run linter checks

npm run lint

Local execution for testing

npm start

MseeP.ai Security Assessment Badge

Collaboration Guide

Refer to CONTRIBUTING.md for guidelines on contributing code or documentation to this project.

Licensing Information

This software package is distributed under the terms of the MIT License. Detailed terms are available in the LICENSE file.

Version History

0.1.0 (2025-04-27)

  • Initialized codebase and core capabilities for managing OneNote structural elements.
  • Successfully published artifact to the public npm repository.

0.1.1 (2025-04-27)

  • Ensured package.json correctly defines the executable binary.
  • Resolved an issue preventing correct execution via the npx command utility.
  • Enhanced the README with clearer deployment and execution directives.

WIKIPEDIA: Cloud computing is "a paradigm for enabling network access to a scalable and elastic pool of shareable physical or virtual resources with self-service provisioning and administration on-demand," according to ISO. It is commonly referred to as "the cloud".

== Characteristics == In 2011, the National Institute of Standards and Technology (NIST) identified five "essential characteristics" for cloud systems. Below are the exact definitions according to NIST:

On-demand self-service: "A consumer can unilaterally provision computing capabilities, such as server time and network storage, as needed automatically without requiring human interaction with each service provider." Broad network access: "Capabilities are available over the network and accessed through standard mechanisms that promote use by heterogeneous thin or thick client platforms (e.g., mobile phones, tablets, laptops, and workstations)." Resource pooling: " The provider's computing resources are pooled to serve multiple consumers using a multi-tenant model, with different physical and virtual resources dynamically assigned and reassigned according to consumer demand." Rapid elasticity: "Capabilities can be elastically provisioned and released, in some cases automatically, to scale rapidly outward and inward commensurate with demand. To the consumer, the capabilities available for provisioning often appear unlimited and can be appropriated in any quantity at any time." Measured service: "Cloud systems automatically control and optimize resource use by leveraging a metering capability at some level of abstraction appropriate to the type of service (e.g., storage, processing, bandwidth, and active user accounts). Resource usage can be monitored, controlled, and reported, providing transparency for both the provider and consumer of the utilized service. By 2023, the International Organization for Standardization (ISO) had expanded and refined the list.

== History ==

The history of cloud computing extends to the 1960s, with the initial concepts of time-sharing becoming popularized via remote job entry (RJE). The "data center" model, where users submitted jobs to operators to run on mainframes, was predominantly used during this era. This was a time of exploration and experimentation with ways to make large-scale computing power available to more users through time-sharing, optimizing the infrastructure, platform, and applications, and increasing efficiency for end users. The "cloud" metaphor for virtualized services dates to 1994, when it was used by General Magic for the universe of "places" that mobile agents in the Telescript environment could "go". The metaphor is credited to David Hoffman, a General Magic communications specialist, based on its long-standing use in networking and telecom. The expression cloud computing became more widely known in 1996 when Compaq Computer Corporation drew up a business plan for future computing and the Internet. The company's ambition was to superch

See Also

`