Onenote Browser

🚀 OneNote MCP Server

A Model Context Protocol (MCP) server for automating browsing and interacting with the OneNote web application through a browser. This server enables AI assistants and other MCP-compatible clients to programmatically browse and interact with OneNote notebooks shared via web links.

✨ Features

• Navigate the hierarchical structure of OneNote (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 sessions

📦 Requirements

• Python 3.10 or higher
• browser-use 0.1.40 or higher
• MCP SDK 1.2.0 or higher
• Playwright
• Internet connection
• A OneNote notebook URL shared via a web link (accessible without authentication)

📦 Installation

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

# Install packages and dependencies
pip install -e .

# Install Playwright browsers
playwright install

💻 Usage Examples

Basic Usage

You can run the server directly:

python -m onenote_mcp

Advanced Usage

Integrate with Claude Desktop or other MCP hosts:

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

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

2. Start Claude Desktop, and it will automatically start the OneNote MCP server.
3. Use the provided tools in your chat with Claude:

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

📚 Documentation

Available Tools

• launch_onenote(shared_url): Open the OneNote web application using 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): Navigate to a specific notebook.
• navigate_to_section_by_name(section_name): Navigate to a specific section.
• navigate_to_page_by_name(page_name): Navigate 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 for a specific term in OneNote.
• 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.

🔧 Technical Details

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 features.

⚠️ Limitations

• Only applicable to OneNote notebooks shared via public links (without authentication).
• The server may need adjustment if the OneNote web interface changes.
• Browser automation can be somewhat fragile and dependent on the UI structure.
• Performance may vary depending on network conditions and OneNote's response speed.

📄 Important Notes

⚠️ Important Note

Please ensure that all required dependencies (Python, browser-use, MCP SDK, and Playwright) are installed.

⚠️ Important Note

Ensure you have a valid OneNote notebook URL before running the server.

💡 Usage Tip

If you encounter any issues, check the logs or refer to the relevant documentation.