Cursor Notebook MCP

What it does

This MCP server enables AI agents, particularly within Cursor, to overcome limitations in editing Jupyter Notebooks. It provides a comprehensive suite of tools for manipulating .ipynb files, allowing agents to create, read, edit, and export notebook cells while maintaining structural integrity via the nbformat library.

Tools

• notebook_create: Creates a new empty notebook.
• notebook_read: Reads entire notebook structure.
• notebook_edit_cell: Replaces source content of a specific cell.
• notebook_add_cell: Adds new code or markdown cells.
• notebook_search: Searches cells for keywords with snippets.
• notebook_export: Exports notebooks to Python or HTML using nbconvert.
• notebook_get_outline: Generates a navigation outline of the notebook.
• notebook_bulk_add_cells: Efficiently adds multiple cells in one operation.

Installation

To install via pip:

pip install cursor-notebook-mcp

Configure in claude_desktop_config.json or Cursor's mcp.json:

{
  "mcpServers": {
    "notebook_mcp": {
      "command": "cursor-notebook-mcp",
      "args": ["--allow-root", "/absolute/path/to/your/notebooks"]
    }
  }
}

Supported hosts

• cursor
• claude
• vscode-copilot