Opens a connection to a Google Colab browser session and unlocks notebook editing tools. Returns a boolean representing whether the connection attempt succeeded

Inserts a code type cell at the provided index and shifts existing cells. The resulting new cell id is returned.

Inserts a text type cell at the provided index and shifts existing cells. The resulting new cell id is returned.

Deletes the cell with the provided cell ID.

Gets a range of cells as JSON from the notebook.

Moves a cell to the provided index and shifts existing cells.

Executes the code in the cell with the provided cell ID. The cell must be a code cell type. The output of the cell execution is returned.

Overwrites the contents of the cell with the provided new content. The cell must already exist and is identified by its cell ID.

Sets environment variables in the current Colab Python runtime by executing a generated setup cell.

Restarts the current Colab Python runtime. The notebook page stays open, but the runtime state and environment variables are reset.

Disconnects and releases/unassigns the active Colab CPU/GPU runtime instance. Call this as the final cleanup step after training or long runtime work is complete or cancelled. Download needed weights, logs, and artifacts first because /content files can be lost after release. This does not uninstall the MCP server and does not close the browser tab.

Reruns persisted environment setup cells created by set_env_vars with persist=true.

Checks the current Colab runtime Python, platform, CPU, working directory, and selected package versions.

Uses the controlled Colab browser to connect or reconnect the Colab Python runtime, then waits until terminal-backed runtime tools can see kernel.runtime.

Checks actual GPU availability in the connected Python runtime using nvidia-smi. Call open_colab_browser_connection and connect_runtime first. If no GPU is active this returns status=warning with remediation steps; do not rely on UI text alone.

Uses the controlled Colab browser to choose an accelerator such as T4 GPU. Applying may restart/disconnect the runtime; always call open_colab_browser_connection, connect_runtime, then check_gpu afterwards.

Captures CPU, memory, disk, and GPU usage through Colab Terminal and optionally appends it to a JSONL file.

Runs a short shell command through Colab Terminal and waits for completion. Do NOT use this for training or long jobs; use start_background_command plus watch_background_command instead.

Preferred tool for training and long jobs. Starts a background shell command through Colab Terminal, writes stdout/stderr to a log file, and records status for watch_background_command.

Checks through Colab Terminal the status of a background command started by start_background_command.

Returns through Colab Terminal the last lines or bytes from a file in the Colab runtime, useful for background command logs.

Stops through Colab Terminal a background command started by start_background_command.

Imports cells from a local .ipynb file into the current Colab notebook.

Exports the current Colab notebook cells to a local .ipynb file on the machine running Codex/MCP.

Alias for export_notebook. Downloads the current Colab notebook cells to a local .ipynb file on the machine running Codex/MCP.

Alias for import_notebook. Uploads cells from a local .ipynb file into the current Colab notebook.

Runs a list of code cells in order and returns per-cell outputs.

Runs code cells in an inclusive index range.

Runs all code cells in notebook order.

Best-effort queued cell cancellation. Returns no-op status when Colab queue controls are not exposed through MCP.

Returns a single cell by cell ID.

Finds cells by source or output text.

Bulk inserts cells and optionally deletes existing cells first.

Partially updates a cell. Currently supports source/content updates.

Returns best-effort execution status for selected cells or all cells.

Polls cell status until every selected cell reaches one of the target states.

Returns outputs for selected cells.

Polls selected cell outputs for a short period and returns the latest outputs.

Reads environment variables from the Colab runtime with secret redaction in text output.

Unsets environment variables in the current Colab Python runtime.

Loads a local .env file and applies it to the current Colab Python runtime.

Lists through Colab Terminal background commands registered by start_background_command.

Polls through Colab Terminal a background command and returns status plus recent log tail.

Writes a base64 encoded file into the Colab runtime through Colab's browser file upload API without consuming a notebook cell execution slot.

Uploads a file from the local machine running this MCP server to the Colab runtime. Prefer this over upload_file when the source is a local path.

Reads a file from the Colab runtime through Colab's /files download API and returns base64 content without consuming a notebook cell execution slot.

Downloads a file from the Colab runtime to a local path on the machine running this MCP server. Prefer this over download_file when the target is a local file.

Appends or writes one base64 chunk to a temporary upload file in the Colab runtime through Colab's browser file upload API.

Moves a temporary chunked upload into its final runtime path through Colab's browser file upload API.

Reads one base64 chunk from a file in the Colab runtime through Colab's /files download API.

Stats a path in the Colab runtime through Colab's runtime file APIs.

Lists files in the Colab runtime through Colab's contents API.

Deletes a file or directory in the Colab runtime through Colab's contents API.

Creates a directory in the Colab runtime through Colab's contents API.

Samples GPU utilization with nvidia-smi through Colab Terminal and optionally writes JSONL.

Starts a lightweight nvidia-smi background sampler through Colab Terminal that writes timestamped JSONL samples.

Stops a GPU monitor started by start_gpu_monitor.

Reads recent JSONL samples from a GPU monitor file.

Returns the local Colab MCP WebSocket connection details and scratch URL for manually connecting a browser.