OneNote MCP Server logo

OneNote MCP Server

by hwillGIT

An MCP server for browsing and interacting with OneNote web app using browser automation. It enables AI assistants and other MCP-compatible clients to programmatically browse and interact with OneNote notebooks shared via web links.

View on GitHub

Last updated: N/A

What is OneNote MCP Server?

The OneNote MCP Server is a Model Context Protocol (MCP) server that allows programmatic interaction with the OneNote web application. It uses browser automation to enable AI assistants and other MCP-compatible clients to browse and manipulate OneNote notebooks that are shared via web links.

How to use OneNote MCP Server?

To use the server, you can run it in standalone mode or integrate it with an MCP host like Claude Desktop. Configuration involves setting up the server command and arguments in the host's configuration file. Once configured, you can use available tools to interact with OneNote through the host's interface, such as launching OneNote with a shared URL and navigating notebooks.

Key features of OneNote MCP Server

  • Navigate OneNote's hierarchical structure

  • Read page content from OneNote

  • Add new content to existing pages

  • Create new pages

  • Search within OneNote

Use cases of OneNote MCP Server

  • Automated note-taking and organization

  • Integration with AI assistants for information retrieval

  • Programmatic content creation and modification in OneNote

  • Automated data extraction from OneNote notebooks

FAQ from OneNote MCP Server

What is the main purpose of this server?

To provide a programmatic interface for interacting with OneNote web app using browser automation, enabling AI assistants to access and manipulate OneNote notebooks.

What are the requirements for running this server?

Python 3.10+, browser-use 0.1.40+, MCP SDK 1.2.0+, Playwright, internet connection, and a shared OneNote notebook URL.

How do I install the server?

Clone the repository, navigate to the project directory, run pip install -e ., and install Playwright browsers with playwright install.

Can I use this with notebooks that require authentication?

No, it only works with OneNote notebooks that are shared with a public link (no authentication required).

What should I do if the server fails to connect to OneNote?

Ensure the shared link is accessible without login. If selectors fail, the OneNote UI may have changed, so check the server code. Check the server logs for error details.