Jupyter Notebook ManagerSAFE

An MCP server for managing and interacting with Jupyter notebooks programmatically.

Components

Tools

The server provides six tools for notebook manipulation:

1. read_notebook_with_outputs: Read a notebook's content including cell outputs

• Required: notebook_path (string)

1. read_notebook_source_only: Read notebook content without outputs

• Required: notebook_path (string)
• Use when size limitations prevent reading full notebook with outputs

1. read_output_of_cell: Read output of a specific cell

• Required:
• notebook_path (string)
• cell_id (string)

1. add_cell: Add new cell to notebook

• Required:
• notebook_path (string)
• source (string)
• Optional:
• cell_type (string): "code" or "markdown"
• position (integer): insertion index (-1 to append)

1. edit_cell: Modify existing cell content

• Required:
• notebook_path (string)
• cell_id (string): Unique ID of the cell to edit
• source (string)

1. execute_cell: Execute a specific cell and return its output
2. Required:
3. notebook_path (string)
4. cell_id (string)
5. Useful for verifying cell execution and output

Usage with Claude Desktop

Step1: Start JupyterLab or Jupyter Notebook

By using uv to run Jupyter notebooks it's much easier to manage venv and package installations.

Follow uv jupyter docummentation for more details.

uv venv --seed
source .venv/bin/activate
uv pip install jupyterlab
.venv/bin/jupyter lab

NOTE: this environment should be used as UV_PROJECT_ENVIRONMENT env variable in MCP server (next step). Run in the same folder where Jupyter started.

echo $(pwd)/.venv

Step2: Configure Claude Desctop Add this configuration to your Claude Desktop config file: