How to add JupyterMCP to Cursor

Connect Claude to Jupyter Notebook 6.x to insert, execute, edit and manage cells via MCP. Paste the config into ~/.cursor/mcp.json and restart Cursor.

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

Cursor 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 Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
2Paste the JupyterMCP config below into the "mcpServers" object.
3Fill in placeholder secrets, then save.
4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
5Ask Cursor to use one of JupyterMCP's tools to confirm it's connected.

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 Cursor

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 + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the JupyterMCP config there under the "mcpServers" key and restart the client.

Is JupyterMCP safe to use with Cursor?

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