Read a Jupyter Notebook (.ipynb) and return structure summary.

Args: ipynb_filepath: Path to Jupyter Notebook (.ipynb) file (absolute path preferred)

Returns: Dictionary with cell_count, cell_types, kernel_info, format_version or dict with 'error' key on failure

List all cells in a Jupyter Notebook (.ipynb) with indices, types, and content previews.

Args: ipynb_filepath: Path to Jupyter Notebook (.ipynb) file (absolute path preferred)

Returns: Dict with 'cells' list or 'error' key on failure

Get content of a specific cell by index from a Jupyter Notebook (.ipynb).

Args: ipynb_filepath: Path to Jupyter Notebook (.ipynb) file (absolute path preferred) cell_index: Index of cell (supports negative indexing)

Returns: Dict with 'content' or 'error' key

Search for pattern in cell content of a Jupyter Notebook (.ipynb).

Args: ipynb_filepath: Path to Jupyter Notebook (.ipynb) file (absolute path preferred) pattern: Search pattern (regex supported) case_sensitive: Whether search is case-sensitive (default: False)

Returns: Dict with 'results' list or 'error' key

Replace entire cell content in a Jupyter Notebook (.ipynb).

Args: ipynb_filepath: Path to Jupyter Notebook (.ipynb) file (absolute path preferred) cell_index: Index of cell to replace new_content: New content for cell (provide as raw string, no additional escaping needed)

Returns: Dict with 'success' or 'error' key

Insert new cell at specified position in a Jupyter Notebook (.ipynb).

Args: ipynb_filepath: Path to Jupyter Notebook (.ipynb) file (absolute path preferred) cell_index: Position to insert cell (0-based indexing) content: Cell content (provide as raw string, no additional escaping needed) cell_type: Type of cell ('code', 'markdown', 'raw')

Returns: Dict with 'success' and 'new_cell_count' or 'error' key

Note: Indices of cells at or after the insertion point will shift by +1

Append cell to end of a Jupyter Notebook (.ipynb).

Args: ipynb_filepath: Path to Jupyter Notebook (.ipynb) file (absolute path preferred) content: Cell content (provide as raw string, no additional escaping needed) cell_type: Type of cell ('code', 'markdown', 'raw')

Returns: Dict with 'success' and 'cell_index' or 'error' key (0-based index of new cell)

Delete cell at specified index in a Jupyter Notebook (.ipynb).

Args: ipynb_filepath: Path to Jupyter Notebook (.ipynb) file (absolute path preferred) cell_index: Index of cell to delete (0-based indexing)

Returns: Dict with 'success' and 'new_cell_count' or 'error' key

Note: Indices of cells after the deleted cell will shift by -1

Replace substring within cell content in a Jupyter Notebook (.ipynb).

Args: ipynb_filepath: Path to Jupyter Notebook (.ipynb) file (absolute path preferred) cell_index: Index of cell old_str: String to replace (provide as raw string, no additional escaping needed) new_str: Replacement string (provide as raw string, no additional escaping needed)

Returns: Dict with 'success' or 'error' key

Get Jupyter Notebook (.ipynb) or cell metadata.

Args: ipynb_filepath: Path to Jupyter Notebook (.ipynb) file (absolute path preferred) cell_index: Index of cell (None for notebook metadata)

Returns: Metadata dictionary or dict with 'error' key

Update Jupyter Notebook (.ipynb) or cell metadata.

Args: ipynb_filepath: Path to Jupyter Notebook (.ipynb) file (absolute path preferred) metadata: Metadata dictionary to merge cell_index: Index of cell (None for notebook metadata)

Returns: Dict with 'success' or 'error' key

Set kernel specification for a Jupyter Notebook (.ipynb).

Args: ipynb_filepath: Path to Jupyter Notebook (.ipynb) file (absolute path preferred) kernel_name: Kernel name (e.g., 'python3') display_name: Display name (e.g., 'Python 3') language: Programming language (default: 'python')

Returns: Dict with 'success' or 'error' key

List common Jupyter Notebook kernel configurations.

Returns: Dict with 'kernels' list

Replace multiple cells in one operation in a Jupyter Notebook (.ipynb).

Args: ipynb_filepath: Path to Jupyter Notebook (.ipynb) file (absolute path preferred) replacements: List of dicts with 'cell_index' and 'content' keys (provide content as raw strings, no additional escaping needed)

Returns: Dict with 'success' and 'cells_modified' or 'error' key

Delete multiple cells by indices from a Jupyter Notebook (.ipynb).

Args: ipynb_filepath: Path to Jupyter Notebook (.ipynb) file (absolute path preferred) cell_indices: List of cell indices to delete (0-based indexing)

Returns: Dict with 'success', 'cells_deleted', 'new_cell_count' or 'error' key

Note: Deletions are processed in descending order to maintain index validity. Provide indices as they appear before any deletions occur.

Insert multiple cells at specified positions in a Jupyter Notebook (.ipynb).

Args: ipynb_filepath: Path to Jupyter Notebook (.ipynb) file (absolute path preferred) insertions: List of dicts with 'cell_index', 'content', 'cell_type' keys (provide content as raw strings, no additional escaping needed)

Returns: Dict with 'success' and 'cells_inserted' or 'error' key

Note: Uses 0-based indexing. Insertions are processed in order, so later indices will be affected by earlier insertions. Consider sorting by index descending to maintain intended positions.

Search and replace across all cells in a Jupyter Notebook (.ipynb).

Args: ipynb_filepath: Path to Jupyter Notebook (.ipynb) file (absolute path preferred) pattern: Pattern to search for (regex) replacement: Replacement string cell_type: Optional filter by cell type

Returns: Dict with 'success' and 'replacements_made' or 'error' key

Reorder cells in a Jupyter Notebook (.ipynb) by providing new index mapping.

Args: ipynb_filepath: Path to Jupyter Notebook (.ipynb) file (absolute path preferred) new_order: List of indices in desired order (0-based indexing)

Returns: Dict with 'success' or 'error' key

Keep only cells matching criteria in a Jupyter Notebook (.ipynb), delete others.

Args: ipynb_filepath: Path to Jupyter Notebook (.ipynb) file (absolute path preferred) cell_type: Optional filter by cell type pattern: Optional regex pattern to match

Returns: Dict with 'success', 'cells_kept' or 'error' key

Merge multiple Jupyter Notebooks (.ipynb) into one.

Args: output_ipynb_filepath: Path for merged notebook (absolute path preferred) input_ipynb_filepaths: List of notebook paths to merge (absolute paths preferred) add_separators: Whether to add separator cells between notebooks

Returns: Dict with 'success', 'total_cells', 'notebooks_merged' or 'error' key

Split a Jupyter Notebook (.ipynb) into multiple files by criteria.

Args: ipynb_filepath: Path to Jupyter Notebook (.ipynb) file (absolute path preferred) output_dir: Directory for output files split_by: Split criteria ('markdown_headers' or 'cell_count')

Returns: Dict with 'success' and 'files_created' or 'error' key

Apply same operation to multiple Jupyter Notebooks (.ipynb).

Args: ipynb_filepaths: List of notebook paths (absolute paths preferred) operation: Operation name ('set_kernel', 'clear_outputs', 'update_metadata') operation_params: Parameters for the operation as a dictionary

Returns: Dict with 'success' and 'results' or 'error' key

Search across multiple Jupyter Notebooks (.ipynb).

Args: ipynb_filepaths: List of notebook paths (absolute paths preferred) pattern: Search pattern (regex) return_context: Whether to include context

Returns: Dict with 'results' and 'match_count' or 'error' key

Synchronize metadata across multiple Jupyter Notebooks (.ipynb).

Args: ipynb_filepaths: List of notebook paths (absolute paths preferred) metadata: Metadata to apply merge: Whether to merge with existing metadata

Returns: Dict with 'success' and 'notebooks_updated' or 'error' key

Extract matching cells from multiple Jupyter Notebooks (.ipynb) into a new notebook.

Args: output_ipynb_filepath: Path for output notebook (absolute path preferred) input_ipynb_filepaths: List of source notebook paths (absolute paths preferred) pattern: Optional regex pattern to match cell_type: Optional cell type filter

Returns: Dict with 'success', 'cells_extracted', 'source_notebooks' or 'error' key

Clear all outputs from code cells in one or more Jupyter Notebooks (.ipynb).

Args: ipynb_filepaths: Single filepath or list of filepaths (absolute paths preferred)

Returns: Dict with 'success' and 'notebooks_processed' or 'error' key

Validate Jupyter Notebook (.ipynb) structure.

Args: ipynb_filepath: Path to Jupyter Notebook (.ipynb) file (absolute path preferred)

Returns: Dict with 'valid' boolean and optional 'errors' list

Get summary information about a Jupyter Notebook (.ipynb).

Args: ipynb_filepath: Path to Jupyter Notebook (.ipynb) file (absolute path preferred)

Returns: Dict with cell_count, cell_types, kernel, format_version, file_size or 'error' key

Validate multiple Jupyter Notebooks (.ipynb).

Args: ipynb_filepaths: List of notebook paths (absolute paths preferred)

Returns: Dict with 'results' mapping filepath to validation status