The Notebook MCP

What it does

The Notebook MCP server allows AI agents to read, create, and manipulate Jupyter Notebook files. It bridges the gap between AI assistants and the .ipynb format, enabling agents to execute cells and modify notebook structures without requiring the user to manually copy-paste code.

Tools

• notebook_create: Creates a new, empty notebook file.
• notebook_read: Returns the entire notebook structure as a dictionary.
• notebook_edit_cell: Replaces the source content of a specific cell.
• notebook_execute_cell: Executes a code cell and returns its outputs (requires active Jupyter server).
• notebook_export: Exports notebooks to formats like Python or HTML.
• notebook_search: Searches for strings across all cells in a notebook.

Installation

To use with Claude Desktop, add this to your claude_desktop_config.json:

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

Supported hosts

• Cursor
• Windsurf
• Claude Desktop
• Claude Code