jupyter-interactive-mcp

An MCP server that gives any MCP-compatible LLM client (Claude Desktop, Claude Code, etc.) full control over a live JupyterLab instance.

Quick start

# Zero-install run via uvx (recommended)
uvx jupyter-interactive-mcp

# Or install permanently
pip install jupyter-interactive-mcp

Claude Desktop config

{
  "mcpServers": {
    "jupyter": {
      "command": "uvx",
      "args": ["jupyter-interactive-mcp"],
      "env": {
        "JUPYTER_URL": "http://localhost:8888",
        "JUPYTER_TOKEN": "<token>"
      }
    }
  }
}

Environment variables

Available tools

• list_notebooks — list all .ipynb files

• get_notebook_info — cell count, kernel name/status

• read_notebook — all cells with source and outputs

• read_cell — single cell source and outputs

• edit_cell — update cell source (clears outputs, saves)

• add_cell — insert a new cell at an index

• delete_cell — remove a cell

• run_cell — execute a cell in the kernel, returns text/images

• restart_kernel — restart the notebook kernel

• interrupt_kernel — interrupt a running kernel

• get_kernel_status — idle/busy/starting status