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

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Enables AI language models to interact with Microsoft OneNote via a standardized interface, supporting notebook and page management through natural language.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Metabase Server MCP
berry-street
-
security
F
license
-
quality
Enables AI assistants to interact with Metabase, providing access to dashboards, questions, databases, and tools for executing queries and viewing data through natural language.
Last updated -
JavaScript
OneNote MCP Server
hwillGIT
-
security
F
license
-
quality
An MCP server that enables AI assistants to programmatically browse and interact with OneNote notebooks shared via web links through browser automation.
Last updated -
JavaScript
Office Word MCP Server
GongRzhe
A
security
A
license
A
quality
A Model Context Protocol server that enables AI assistants to create, read, edit, and format Microsoft Word documents through standardized tools and resources.
Last updated -
16
259
Python
MIT License
Joplin MCP Server
dweigend
-
security
A
license
-
quality
A server that enables AI assistants to access and manipulate Joplin notes through the Model Context Protocol, allowing search, reading, editing, and management of notes using natural language.
Last updated -
2
Python
MIT License

View all related MCP servers

OneNote MCP Server