# 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

```bash
# 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:

```bash
python -m onenote_mcp
```

### Integration with Claude Desktop or other MCP hosts

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

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

2. Launch Claude Desktop, which will automatically start the OneNote MCP server
3. 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