onb-mcp

# Open Notebook MCP Server [English] | [日本語](docs/README/JA.md) | [简体中文](docs/README/ZH.md) <!-- mcp-name: io.github.rmc8/onb-mcp --> An MCP (Model Context Protocol) server that provides tools to interact with the [Open Notebook](https://github.com/lfnovo/open-notebook) API. This server enables AI assistants like Claude to manage notebooks, sources, notes, search content, and interact with AI models through Open Notebook. ## Features - **Notebooks Management**: Create, read, update, and delete notebooks - **Sources Management**: Add and manage content sources (links, uploads, text) - **Notes Management**: Create and organize notes within notebooks - **Search & AI**: Search content using vector/text search and ask questions - **Models Management**: Configure and manage AI models - **Chat Sessions**: Create and manage chat conversations - **Settings**: Access and update application settings - **Progressive Disclosure**: Efficient tool discovery with `search_capabilities` ## Quick Start with uvx (Recommended) Since this package is published on PyPI, you do not need to clone or install it manually. You can run the server instantly using **`uvx`** (the tool runner for `uv`): ```bash # Run the MCP server instantly uvx onb-mcp ``` ### Using with Claude Desktop Add the server to your Claude Desktop configuration (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS, or `%APPDATA%\Claude\claude_desktop_config.json` on Windows): ```json { "mcpServers": { "open-notebook": { "command": "uvx", "args": [ "onb-mcp" ], "env": { "OPEN_NOTEBOOK_URL": "http://localhost:5055", "OPEN_NOTEBOOK_PASSWORD": "your_password_here" } } } } ``` ## Configuration The server requires configuration to connect to your Open Notebook instance: ### Environment Variables Set these environment variables in your MCP client configuration (e.g. Claude Desktop config): ```bash # Required: URL of your Open …