Skip to main content
Glama
Epochal-dev

Open Notebook MCP Server

by Epochal-dev
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
MCP_TRANSPORTNoOptional transport configuration (default: stdio)stdio
OPEN_NOTEBOOK_URLYesURL of your Open Notebook instance
OPEN_NOTEBOOK_PASSWORDNoOptional authentication password (if APP_PASSWORD is set in Open Notebook)

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
search_capabilitiesA

Search tools exposed by this server with progressive detail levels.

Args:
    query: Search query to filter tools
    detail: Level of detail - 'name' (minimal), 'summary' (default), or 'full' (complete)
    limit: Maximum number of results (1-50)

Returns:
    Dictionary with request_id, query, detail, count, matches, and hint fields
list_notebooksA

Get all notebooks with optional filtering and ordering.

Args:
    archived: Filter by archived status (None = all, True = archived only, False = active only)
    order_by: Order by field and direction (e.g., 'created desc', 'name asc')
    limit: Maximum number of results (1-100)

Returns:
    Dictionary with notebooks list and metadata
get_notebookB

Get a specific notebook by ID.

Args:
    notebook_id: Notebook ID (e.g., 'notebook:abc123')

Returns:
    Notebook details
create_notebookC

Create a new notebook.

Args:
    name: Notebook name
    description: Optional notebook description

Returns:
    Created notebook details
update_notebookA

Update a notebook.

Args:
    notebook_id: Notebook ID
    name: Optional new name
    description: Optional new description
    archived: Optional archived status

Returns:
    Updated notebook details
delete_notebookC

Delete a notebook.

Args:
    notebook_id: Notebook ID

Returns:
    Success message
list_sourcesA

Get all sources with optional filtering.

Args:
    notebook_id: Optional notebook ID to filter by
    limit: Maximum number of results (1-100)
    offset: Pagination offset

Returns:
    Dictionary with sources list and metadata
get_sourceA

Get a specific source by ID.

Args:
    source_id: Source ID (e.g., 'source:abc123')

Returns:
    Source details
create_sourceC

Create a new source (link, upload, or text).

Args:
    notebook_id: Notebook ID to add source to
    type: Source type ('link', 'upload', or 'text')
    url: URL for link type sources
    title: Optional title
    embed: Whether to generate embeddings (default: True)

Returns:
    Created source details
update_sourceC

Update a source.

Args:
    source_id: Source ID
    title: Optional new title
    topics: Optional list of topics

Returns:
    Updated source details
delete_sourceB

Delete a source.

Args:
    source_id: Source ID

Returns:
    Success message
list_notesA

Get all notes with optional filtering.

Args:
    notebook_id: Optional notebook ID to filter by
    limit: Maximum number of results (1-100)
    offset: Pagination offset

Returns:
    Dictionary with notes list and metadata
get_noteB

Get a specific note by ID.

Args:
    note_id: Note ID (e.g., 'note:abc123')

Returns:
    Note details
create_noteB

Create a new note.

Args:
    notebook_id: Notebook ID to add note to
    title: Note title
    content: Note content
    topics: Optional list of topics

Returns:
    Created note details
update_noteC

Update a note.

Args:
    note_id: Note ID
    title: Optional new title
    content: Optional new content
    topics: Optional list of topics

Returns:
    Updated note details
delete_noteC

Delete a note.

Args:
    note_id: Note ID

Returns:
    Success message
searchB

Search content using vector or text search.

Args:
    query: Search query
    type: Search type ('vector' or 'text')
    notebook_id: Optional notebook ID to limit search
    limit: Maximum number of results (1-50)

Returns:
    Search results
ask_questionC

Ask a question about your content with detailed control.

Args:
    question: Question to ask
    strategy_model: Model ID for strategy generation
    answer_model: Model ID for answering
    final_answer_model: Model ID for final answer synthesis
    notebook_id: Optional notebook ID to limit context

Returns:
    Answer with sources and reasoning
ask_simpleC

Ask a question about your content with simplified interface.

Args:
    question: Question to ask
    strategy_model: Model ID for strategy generation
    answer_model: Model ID for answering
    final_answer_model: Model ID for final answer synthesis
    notebook_id: Optional notebook ID to limit context

Returns:
    Simple answer
list_modelsB

Get all configured AI models.

Args:
    limit: Maximum number of results (1-100)

Returns:
    Dictionary with models list and metadata
get_modelB

Get a specific model by ID.

Args:
    model_id: Model ID (e.g., 'model:abc123')

Returns:
    Model details
create_modelC

Create a new AI model configuration.

Args:
    name: Model name (e.g., 'gpt-4', 'claude-3-opus')
    provider: Provider name (e.g., 'openai', 'anthropic')
    type: Model type (e.g., 'language', 'embedding')

Returns:
    Created model details
delete_modelC

Delete a model configuration.

Args:
    model_id: Model ID

Returns:
    Success message
get_default_modelsA

Get default model configurations.

Returns:
    Default models configuration
list_chat_sessionsB

Get all chat sessions with optional filtering.

Args:
    notebook_id: Optional notebook ID to filter by
    limit: Maximum number of results (1-100)

Returns:
    Dictionary with sessions list and metadata
create_chat_sessionC

Create a new chat session.

Args:
    notebook_id: Notebook ID for the session
    title: Session title

Returns:
    Created session details
get_chat_sessionA

Get a specific chat session by ID.

Args:
    session_id: Session ID (e.g., 'session:abc123')

Returns:
    Session details with message history
update_chat_sessionC

Update a chat session.

Args:
    session_id: Session ID
    title: Optional new title

Returns:
    Updated session details
delete_chat_sessionC

Delete a chat session.

Args:
    session_id: Session ID

Returns:
    Success message
execute_chatC

Send a message in a chat session.

Args:
    session_id: Session ID
    message: Message to send
    context: Optional context data for the conversation

Returns:
    Chat response with AI message
get_chat_contextC

Build context for a chat conversation.

Args:
    notebook_id: Notebook ID
    context_config: Optional context configuration

Returns:
    Built context data
get_settingsB

Get application settings.

Returns:
    Application settings
update_settingsC

Update application settings.

Args:
    settings: Settings dictionary to update

Returns:
    Updated settings

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

B3.3/5.0

Scored across 33 tools

Disambiguation4/5

Most tools have clear distinct purposes, but 'ask_question' and 'ask_simple' are very similar in functionality and arguments, potentially causing confusion for an agent. Other tools like CRUD operations are well-separated.

Naming Consistency5/5

All tool names follow a consistent verb_noun pattern with lowercase and underscores (e.g., create_notebook, delete_source). No mixing of conventions or irregular names.

Tool Count4/5

With 33 tools, the server is on the higher side but still reasonable given the multiple resources (notebooks, notes, sources, chat sessions, models, settings) and additional utility tools. It's slightly over the typical well-scoped range but not excessive.

Completeness4/5

The tool surface covers CRUD operations for all major resources and includes question-asking and search features. Minor gaps like import/export or bulk operations are missing, but core workflows are well-supported.

Maintenance

ActivityInactive
ResponsivenessUnresponsive

Resources