OneNote

You can run a dedicated MCP server to interact with Microsoft OneNote through a standardized interface. This server lets you list, create, read, update, and delete notebooks, sections, and pages, enabling AI models to manage OneNote content programmatically.

How to use

You connect your MCP client to the OneNote MCP Server to perform common notebook operations. With a single server you can organize your notes by notebooks and sections, create and update pages with HTML content, and search across all notebooks. Use the client configuration to point at the local stdio MCP process, then issue natural language prompts to manage your OneNote data.

Typical usage patterns include creating a new notebook, adding sections, creating and editing pages with HTML content, reading page details, and performing searches across notebooks. The server exposes a consistent set of actions for notebooks, sections, and pages so your AI workflows can handle content creation and retrieval in OneNote without manual UI interactions.

How to install

Prerequisites: you need Node.js and npm installed on your system.

# Install the MCP server globally
npm install -g mcp-server-onenote

Additional sections

Configuration involves providing Azure credentials to access Microsoft Graph for OneNote data. You need to register an Azure app, grant Graph permissions, and supply the tenant, client IDs, and client secret to the MCP server.

Using with an MCP client, configure the client to run the MCP server as a local process. The following example shows how to start the server via npx and supply the required Azure credentials.

{
  "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 App Registration

1. Go to the Azure Portal and navigate to App registrations.
2. Create a new registration.
3. Add Microsoft Graph API permissions: Notes.ReadWrite.All and Notes.Read.All.
4. Create a client secret.
5. Copy the tenant ID, client ID, and client secret for configuration.

Development

Development tasks involve installing dependencies, running tests, building, and linting. Use the commands below to set up and verify your environment.

# Install dependencies
npm install

# Run tests
npm test

# Build
npm run build

# Lint
npm run lint

Available tools

Notebook management

List notebooks, create new notebooks, get notebook details, and delete notebooks.

Section management

List sections in a notebook, create new sections, get section details, and delete sections.

Page management

List pages in a section, create new pages with HTML content, read page content, update page content, delete pages, and search pages across notebooks.