Skip to main content

notebook

Read and edit Jupyter notebooks. Parses the .ipynb JSON structure directly — no running kernel required for read/edit operations.

PropertyValue
Module IDnotebook
Version1.0.0
Typeuser
DependenciesNone (stdlib only)

Design Philosophy​

  • Zero dependencies — notebooks are JSON files. We parse them with Python's built-in json module.
  • No kernel needed — reading and editing cells works without Jupyter. Only execution would require a kernel (not implemented).
  • Output-aware — cell outputs (text, errors, images) are extracted and formatted for agent consumption.

Configuration​

modules:
  notebook: {}

No configuration required.

Actions (4)​

read​

Read a notebook: all cells with source code, markdown, and outputs. Supports cell range selection. Parameters: path, cell_range. Risk: low

edit_cell​

Replace the content of a cell by index. Optionally change cell type. Parameters: path, cell_index, content, cell_type. Risk: medium

add_cell​

Add a new cell at a specific position or at the end. Parameters: path, content, cell_type, position. Risk: medium

delete_cell​

Delete a cell by index. Parameters: path, cell_index. Risk: medium