Skip to main content
Glama
Sign In
onenote-mcp

onenote-mcp

by seanGSISG
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

OneNote MCP Server

A stdio Model Context Protocol server for Microsoft OneNote. It uses Microsoft Graph delegated permissions and Microsoft device-code authentication.

Requirements

  • Node.js 20 or newer

  • A Microsoft account with OneNote access

  • An MCP client such as Codex

Related MCP server: OneNoteMCP

Install

Option 1: Add from the desktop GUI

  1. Open the Codex desktop app, select Plugins, open Create, and select Add marketplace.

    Select Add marketplace from the Create menu

  2. Select Add plugin marketplace and enter:

    • Source: https://github.com/seanGSISG/onenote-mcp.git

    • Git ref: main

    • Sparse paths: leave blank

    Enter the OneNote marketplace repository

  3. Select Add marketplace, return to Plugins, and select the Personal tab. If the new marketplace does not appear, completely restart the desktop app and return to Plugins.

  4. Select Sean's OneNote Plugin and choose Install beside Microsoft OneNote.

    Install Microsoft OneNote from the Personal marketplace tab

  5. Restart the desktop app again, open a new task, and ask: Authenticate with OneNote.

Option 2: Let Codex configure it

Paste this into a Codex desktop task—no clone is required:

Read https://raw.githubusercontent.com/seanGSISG/onenote-mcp/main/AGENTS.md and follow it to install the complete OneNote plugin in the Codex desktop app.

Codex will add this repository as a plugin marketplace, install the complete OneNote plugin, verify its MCP server, and explain when a desktop-app restart or new task is required. Users do not need to clone the repository or edit MCP JSON or TOML files.

Option 3: Install for development

git clone https://github.com/seanGSISG/onenote-mcp.git
cd onenote-mcp
npm install
npm test

The MCP SDK is installed from npm. A separate SDK checkout and build are no longer required.

Advanced: MCP-only configuration

Add this to ~/.codex/config.toml, replacing the path with the absolute path to onenote-mcp.mjs:

[mcp_servers.onenote]
type = "stdio"
command = "node"
args = ["C:/absolute/path/to/onenote-mcp.mjs"]
enabled = true
startup_timeout_sec = 30

Restart Codex after changing MCP configuration.

Authentication

  1. Call authenticationStatus.

  2. If unauthenticated, call authenticate.

  3. Open the returned Microsoft device-login URL and enter the returned code. Use force: true to replace a stale or unwanted login.

  4. Call authenticationStatus again to confirm completion.

Authentication starts in the background, so the authenticate tool returns the device code immediately. The delegated access token is stored at ~/.onenote-mcp/access-token.json. Set ONENOTE_TOKEN_PATH to override that location, or supply GRAPH_ACCESS_TOKEN in the server environment. ONENOTE_CLIENT_ID and ONENOTE_TENANT_ID override the default public client and common tenant.

The server requests the delegated Notes.ReadWrite and User.Read scopes.

Tools

Tool

Purpose

authenticationStatus

Check authentication state and expiration

authenticate

Start device-code authentication

listNotebooks

List up to maxResults notebooks

getNotebook

Get one notebook by exact ID

listSections

List up to maxResults sections, optionally in a notebook

listPages

List up to maxResults pages, optionally in a section

getPage

Get page metadata and optionally its HTML

createPage

Create a titled XHTML page in an exact section

searchPages

Search page titles

All resource-specific operations use explicit IDs. The server never silently chooses the first notebook, section, or page.

Development

npm run check
npm test
npm audit

The test suite covers token migration and expiration, asynchronous device-code flow, Graph request construction and errors, XHTML title escaping, and a real MCP stdio handshake.

Available Tools

9 tools
authenticateA
Read-only

Start Microsoft device-code authentication. Immediately returns the login URL and user code; authentication completes in the background.

Inputs: force.

authenticationStatusA
Read-onlyIdempotent

Check whether OneNote is authenticated and whether device-code authentication is pending.

Inputs: no named parameters.

createPageC

Create a OneNote page in an exact section using XHTML content.

Inputs: title (required), sectionId (required), contentHtml (required).

getNotebookA
Read-onlyIdempotent

Get a OneNote notebook by its exact resource ID.

Inputs: notebookId (required).

getPageA
Read-onlyIdempotent

Get a OneNote page by its exact resource ID, including HTML content by default.

Inputs: pageId (required), includeContent.

listNotebooksB
Read-onlyIdempotent

List OneNote notebooks available to the signed-in user.

Inputs: maxResults.

listPagesC
Read-onlyIdempotent

List OneNote page metadata, optionally limited to one section.

Inputs: sectionId, maxResults.

listSectionsA
Read-onlyIdempotent

List OneNote sections, optionally limited to one notebook.

Inputs: maxResults, notebookId.

searchPagesA
Read-onlyIdempotent

Search page titles across OneNote. Returns page metadata; use getPage to read a result.

Inputs: query (required), maxResults.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.5/5.0

    Scored across 9 tools

    Disambiguation5/5

    Each tool has a clear, distinct purpose: authentication, listing/getting notebooks/sections/pages, creating pages, and searching. No overlap or ambiguity.

    Naming Consistency4/5

    Most tools follow a verb_noun pattern (e.g., listNotebooks, createPage). 'authenticationStatus' is a noun phrase but fits the context. Minor deviation is acceptable.

    Tool Count5/5

    9 tools cover the core OneNote operations (auth, notebooks, sections, pages) without being excessive. Perfectly scoped for the domain.

    Completeness3/5

    Covers read and create operations for pages and notebooks, but lacks update and delete for pages and notebooks. Search is present. Notable gaps exist for full CRUD.

    Resources

    Related MCP Connectors

    Related MCP Servers

    • OneNoteMCP

      swax
      A
      license
      Not graded
      quality
      D
      maintenance
      Enables interaction with Microsoft OneNote via the Microsoft Graph API, allowing users to list notebooks and retrieve page content. It supports both personal and organization notebooks with credential caching for efficient authentication.
      34 npm
      3
      MIT

    • OneNote MCP Server

      dcpurnell
      A
      license
      D
      quality
      C
      maintenance
      Enables AI assistants to securely interact with Microsoft OneNote data through the Microsoft Graph API. It supports comprehensive management tasks including searching page content, creating and editing notes, and automating productivity workflows like daily note creation.
      20
      4
      MIT