Open Notebook
Connects Claude to a self-hosted Open Notebook instance for managing research and knowledge bases. Exposes 39 tools across notebooks, sources, notes, vector search, and chat sessions. You can create notebooks, ingest content from URLs or text, generate embeddings, ask questions against your knowledge base using configurable AI models, and manage multi-turn chat conversations. Implements progressive disclosure through a search_capabilities tool to minimize context usage. Supports both local stdio and remote HTTP deployment. Requires pointing it at your Open Notebook API endpoint, with optional password auth if you've locked down your instance.
- GitHub stars
- 30
- tools
- 33
- auth
- Secret needed
- transport
- STDIO
- env vars
- 2
- last updated
- Dec 22, 2025
Tools
33 toolsPublic tool metadata for what this MCP can expose to an agent.
search_capabilitiesProgressive tool discovery
Progressive tool discovery
No parameter schema in public metadata yet.
list_notebooks
No parameter schema in public metadata yet.
get_notebook
No parameter schema in public metadata yet.
create_notebook
No parameter schema in public metadata yet.
update_notebook
No parameter schema in public metadata yet.
delete_notebook
No parameter schema in public metadata yet.
list_sources
No parameter schema in public metadata yet.
get_source
No parameter schema in public metadata yet.
create_source
No parameter schema in public metadata yet.
update_source
No parameter schema in public metadata yet.
delete_source
No parameter schema in public metadata yet.
list_notes
No parameter schema in public metadata yet.
get_note
No parameter schema in public metadata yet.
create_note
No parameter schema in public metadata yet.
update_note
No parameter schema in public metadata yet.
delete_note
No parameter schema in public metadata yet.
search
No parameter schema in public metadata yet.
ask_question
No parameter schema in public metadata yet.
ask_simple
No parameter schema in public metadata yet.
list_models
No parameter schema in public metadata yet.
get_model
No parameter schema in public metadata yet.
create_model
No parameter schema in public metadata yet.
delete_model
No parameter schema in public metadata yet.
get_default_models
No parameter schema in public metadata yet.
list_chat_sessions
No parameter schema in public metadata yet.
create_chat_session
No parameter schema in public metadata yet.
get_chat_session
No parameter schema in public metadata yet.
update_chat_session
No parameter schema in public metadata yet.
delete_chat_session
No parameter schema in public metadata yet.
execute_chat
No parameter schema in public metadata yet.
get_chat_context
No parameter schema in public metadata yet.
get_settings
No parameter schema in public metadata yet.
update_settings
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
OPEN_NOTEBOOK_URL*URL of your Open Notebook instance
OPEN_NOTEBOOK_PASSWORDsecretAuthentication password (if APP_PASSWORD is set in Open Notebook)
Readme
Open Notebook MCP Server
An MCP (Model Context Protocol) server that provides tools to interact with the 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
Installation
Using uv (recommended)
# Clone the repository
git clone https://github.com/PiotrAleksander/open-notebook-mcp.git
cd open-notebook-mcp
# Install with uv
uv sync
Using pip
pip install -e .
Configuration
Details
- Repository
- github.com/epochal-dev/open-notebook-mcp
- Category
- Documents & Knowledge
- Package
open-notebook-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active
Related Documents & Knowledge MCP servers
View all
Agent Knowledgekeshrath/agent-knowledgeCross-session memory for AI agents - knowledge graph, scoring, semantic search19stars
Obsidian Vault MCP Serveroleksandrkucherenko/mcp-obsidian-via-restAccess Obsidian vaults via Local REST API - read, search, and interact with notes13stars
Pdf Toolkit Mcparyanbv/pdf-toolkit-mcpWrite-capable PDF toolkit MCP: 22 tools to read, create, render, encrypt, merge & fill PDFs.7stars
Sunub Obsidian Mcp Serversunub/obsidian-mcp-serverSearch your Obsidian vault to quickly find notes by title or keyword, summarize related content, a…2stars
Google Driveus-all/google-drive-mcp-serverGoogle Drive + Workspace MCP — Docs, Sheets, Slides, Shared Drives, Labels, Approvals, DWD1stars