How to add JupyterMCP to Windsurf

Connect Claude to Jupyter Notebook 6.x to insert, execute, edit and manage cells via MCP. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 129★ · stdio · no auth

Windsurf config for JupyterMCP

git clone https://github.com/jjsantos01/jupyter-notebook-mcp.git

{
  "mcpServers": {
    "jupytermcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/REPO/FOLDER/src",
        "run",
        "jupyter_mcp_server.py"
      ]
    }
  }
}

Setup steps

1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the JupyterMCP config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5JupyterMCP's tools become available to Cascade.

Before you start

Python 3.12 or newer
uv package manager
Claude AI desktop application
Jupyter Notebook 6.x (run via 'jupyter nbclassic'); does NOT work with Jupyter Lab, Notebook v7.x, VS Code Notebooks, or Google Colab

What JupyterMCP can do in Windsurf

ping

Check server connectivity.

insert_and_execute_cell

Insert a cell at the specified position and execute it.

save_notebook

Save the current Jupyter notebook.

get_cells_info

Get information about all cells in the notebook.

get_notebook_info

Get information about the current notebook.

run_cell

Run a specific cell by its index.

run_all_cells

Run all cells in the notebook.

get_cell_text_output

Get the output content of a specific cell (text output limited to 1500 characters by default).

Security

Experimental tool that runs arbitrary Python code on your computer, which could modify or delete data if not used carefully. Always back up important projects and data before use.

JupyterMCP + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the JupyterMCP config there under the "mcpServers" key and restart the client.

Is JupyterMCP safe to use with Windsurf?

Experimental tool that runs arbitrary Python code on your computer, which could modify or delete data if not used carefully. Always back up important projects and data before use.

Which Jupyter versions are supported?

Only Jupyter Notebook 6.x, started with 'uv run jupyter nbclassic'. It does not work with Jupyter Lab, Notebook v7.x, VS Code Notebooks, Google Colab, or other notebook interfaces.

How do I start the connection?

Start Jupyter Notebook 6.x, create a notebook using the 'jupyter-mcp' kernel, then run a cell that imports setup_jupyter_mcp_integration from jupyter_ws_server and calls it to launch the WebSocket server inside Jupyter. Then launch Claude Desktop with MCP enabled.

Can I test it without Claude Desktop?

Yes. Run 'uv run python src/jupyter_ws_external_client.py' for an interactive test menu, or add '--batch' for automated testing of all commands.

View repo Full JupyterMCP page