OneNoteMcpServer.linux-x64 0.0.5

Nokia.MCP.Servers.OneNote.Local

Name

Nokia.MCP.Servers.OneNote.Local

Purpose

This MCP server exposes Microsoft OneNote capabilities to MCP clients over stdio. It authenticates to Microsoft Graph using Entra ID and provides tools for reading notebook, section, and page information, as well as creating and updating OneNote content when write access is enabled.

The server is designed for local MCP usage and is built around the shared OneNote tool set in the Nokia.MCP.Servers.Tools.OneNote namespace.

Configurations

The following environment variables are used by the server:

• ONENOTE_MCP_ALLOW_WRITES – set to 1 to enable write-capable tools such as createPage, appendToPage, and deletePage.
• ONENOTE_MCP_AUTH_MODE – set to device_code to prefer device code authentication in SSH or headless environments.
• ONENOTE_MCP_PERSIST_TOKEN – set to 1, true, yes, or on to persist the MSAL token cache between server runs. When unset or set to 0, false, no, or off, the server clears any previously persisted cache at startup.
• ONENOTE_MCP_CLIENT_ID – required Microsoft Entra public client ID used for authentication.
• ONENOTE_MCP_TENANT_ID – required Microsoft Entra tenant ID used for authentication.
• ONENOTE_MCP_SCOPES – optional override for the Graph scopes, space-delimited.

Tools

The server exposes the following tools from the OneNote tool namespace:

Authentication

• signIn – starts or confirms interactive sign-in for the current server session.
• signOut – clears the current in-memory authentication session.

Notebook and page discovery

• listNotebooks – lists the signed-in user’s notebooks.
• listSections – lists sections, optionally scoped to a notebook.
• listPagesInSection – lists pages in a given OneNote section.
• searchPages – searches pages by title within the user’s notebooks.
• getPageContentText – extracts plain text from a OneNote page’s HTML content.

Write operations

These tools are only registered when ONENOTE_MCP_ALLOW_WRITES=1.

• createPage – creates a new page in a OneNote section.
• appendToPage – appends HTML content to the end of a page.
• deletePage – deletes a OneNote page by id.

Notes

• The server listens over stdio and writes logs to stderr to keep stdout reserved for MCP JSON-RPC traffic.
• Authentication is performed against Microsoft Graph using the OneNote permissions required for notebook and page access.