Cells

delete_cell

Delete specific cells from the currently activated notebook and return the cell source of deleted cells (if include_source=True).

Delete specific cells from the currently activated notebook and return the cell source of deleted cells (if include_source=True).

destructive: yes

Parameters

ParameterTypeRequiredDefaultDescription
cell_indicesarrayyesList of cell indices to delete (0-based)
include_sourcebooleannotrueWhether to include the source of deleted cells
notebook_namestring | nullnonullTarget this specific connected notebook instead of the currently activated one. Use when multiple clients share this server, to avoid racing the shared 'current notebook' pointer. Omit to use the currently activated notebook.

Output

{
  "properties": {
    "result": {
      "description": "Success message with list of deleted cells and their source (if include_source=True)",
      "title": "Result",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "title": "delete_cellOutput",
  "type": "object"
}

Call it

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "delete_cell",
    "arguments": {
      "cell_indices": "<cell_indices>",
      "include_source": true,
      "notebook_name": null
    }
  }
}
result = await session.call_tool("delete_cell", arguments={"cell_indices": "<cell_indices>", "include_source": True, "notebook_name": None})

Source

Registered by the @mcp.tool decorator on delete_cell in jupyter_mcp_server/server.py.