Python Notebook

Clone the python-notebook-mcp repository to your local machine.

git clone https://github.com/UsamaK98/python-notebook-mcp.git
cd python-notebook-mcp

Create a virtual environment and install all required dependencies using uv. On macOS/Linux use the provided install script, or set up manually.

# Automated (macOS/Linux)
bash ./install_unix.sh

# Manual setup
uv venv
source .venv/bin/activate
uv pip install -r requirements.txt

Use the fastmcp CLI to register the server with Claude Desktop under the name 'Jupyter Notebook MCP'.

fastmcp install server.py --name "Jupyter Notebook MCP"

If you prefer manual configuration, add the server to your MCP client config file using the path to your virtual environment's Python binary.

{
  "mcpServers": {
    "jupyter": {
      "command": "/path/to/python-notebook-mcp/.venv/bin/python",
      "args": ["/path/to/python-notebook-mcp/server.py"],
      "autoApprove": ["initialize_workspace"]
    }
  }
}

The first tool call must always be initialize_workspace with the absolute path to the directory containing your notebooks. Relative paths are rejected.

Use natural language to create notebooks, add cells, read outputs, and edit existing cells. The server exposes tools: initialize_workspace, list_notebooks, create_notebook, read_notebook, read_cell, edit_cell, add_cell, read_cell_output, and read_notebook_outputs.