OneNote MCP Server

An MCP (Model Context Protocol) server for browsing and interacting with OneNote web app using browser automation. This server enables AI assistants and other MCP-compatible clients to programmatically browse and interact with OneNote notebooks that are shared via web links.

Features

Navigate OneNote's hierarchical structure (notebooks, sections, pages)
Read page content from OneNote
Add new content to existing pages
Create new pages
Search within OneNote
Take screenshots of the current view
Maintain state across the session

Requirements

Python 3.10 or higher
browser-use 0.1.40 or higher
MCP SDK 1.2.0 or higher
Playwright
Internet connection
A shared OneNote notebook URL (must be accessible without authentication)

Installation

# Clone the repository or create the project structure
# Then navigate to the project directory
cd onenote-mcp

# Install the package and dependencies
pip install -e .

# Install Playwright browsers
playwright install

Usage

Standalone Mode

You can run the server directly with:

python -m onenote_mcp

Integration with Claude Desktop or other MCP hosts

Configure your Claude Desktop to use the OneNote MCP server by editing the configuration file:

{
  "mcpServers": {
    "onenote": {
      "command": "python",
      "args": ["-m", "onenote_mcp"]
    }
  }
}

Launch Claude Desktop, which will automatically start the OneNote MCP server
Use the available tools in your chat with Claude:

Can you help me navigate my OneNote notebook at https://example.com/my-shared-notebook? 
First, please launch OneNote with this URL and tell me what notebooks are available.

Available Tools

launch_onenote(shared_url): Launch the OneNote web app with a shared notebook URL
get_all_notebooks(): List all available notebooks
get_all_sections(): List all sections in the current notebook
get_all_pages(): List all pages in the current section
navigate_to_notebook_by_name(notebook_name): Go to a specific notebook
navigate_to_section_by_name(section_name): Go to a specific section
navigate_to_page_by_name(page_name): Go to a specific page
get_current_page_content(): Get the content of the current page
add_content_to_page(content): Add content to the current page
create_new_page_with_name(page_name): Create a new page
search_in_onenote(search_term): Search OneNote for specific terms
take_screenshot(): Take a screenshot of the current view
get_onenote_state(): Get the current state information
close_onenote(): Close the OneNote session and clean up resources

How It Works

This MCP server uses browser-use, a browser automation framework, to interact with the OneNote web interface. It creates a bridge between MCP-compatible AI assistants and the OneNote web application, enabling programmatic control of OneNote functions.

Limitations

Only works with OneNote notebooks that are shared with a public link (no authentication)
The server may need adjustments if the OneNote web interface changes
Browser automation can be somewhat fragile and dependent on the UI structure
Performance may vary based on network conditions and OneNote's responsiveness

Troubleshooting

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 - check the server code
For other issues, check the server logs for error details

License

MIT

This server cannot be installed

security - not tested

license - not found

quality - not tested

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.

An MCP server that enables AI assistants to programmatically browse and interact with OneNote notebooks shared via web links through browser automation.

Related MCP Servers

OneNote MCP Server
ZubeidHendricks
-
security
F
license
-
quality
Enables AI language models to interact with Microsoft OneNote via a standardized interface, supporting notebook and page management through natural language.
Last updated -
107
6
TypeScript
browser-use MCP Server
co-browser
-
security
A
license
-
quality
An MCP server that enables AI assistants to control a web browser through natural language commands, allowing them to navigate websites and extract information via SSE transport.
Last updated -
505
Python
MIT License
SiYuan Note MCP Server
onigeya
A
security
A
license
A
quality
An MCP server implementation that integrates with SiYuan Note system, enabling AI models to access and manipulate note data through comprehensive commands for notebook management, document operations, and content manipulation.
Last updated -
3
104
1
TypeScript
ISC License
browser-mcp
djyde
-
security
F
license
-
quality
A MCP server that allows AI assistants to interact with the browser, including getting page content as markdown, modifying page styles, and searching browser history.
Last updated -
5
TypeScript

View all related MCP servers

OneNote MCP Server