cursor-notebook-mcp
If you are the rightful owner of cursor-notebook-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
The Jupyter Notebook MCP Server allows AI agents to interact with Jupyter Notebook files, providing tools for direct notebook cell manipulation.
The Jupyter Notebook MCP Server is designed to enable AI agents, particularly within Cursor, to interact with Jupyter Notebook (.ipynb) files. It addresses a limitation in Cursor's Agent mode, where the model could not edit notebooks or cells in response to dialog in the AI chat pane. The server provides a suite of MCP tools for direct notebook cell manipulation, using the nbformat library to safely manipulate notebook structures and nbconvert for exporting notebooks to various formats. It enforces security by restricting operations to user-defined directories and handles all notebook operations through a clean API. The server is versatile and can be configured for use with other platforms like VS Code (Insiders) or Claude Code, as long as they can utilize MCP. The server supports various transport protocols, including Streamable HTTP, SSE, and stdio, and can handle remote notebooks via SFTP.
Features
- notebook_create: Creates a new, empty notebook file.
- notebook_delete: Deletes an existing notebook file.
- notebook_rename: Renames/moves a notebook file from one path to another.
- notebook_read: Reads an entire notebook and returns its structure as a dictionary.
- notebook_add_cell: Adds a new code or markdown cell after a specified index.
Tools
notebook_create
Create a new empty notebook file
notebook_delete
Delete existing notebook files
notebook_rename
Rename/move notebook files
notebook_read
Read the entire notebook structure
notebook_read_cell
Read the source content of a specific cell
notebook_add_cell
Add new cell after specifying index
notebook_edit_cell
Replace the source content of a specific cell
notebook_delete_cell
Delete a specific cell
notebook_change_cell_type
Change cell type
notebook_duplicate_cell
Copy the cell
notebook_get_cell_count
Returns the total number of cells
notebook_read_metadata
Read top-level notebook metadata
notebook_edit_metadata
Update top-level notebook metadata
notebook_read_cell_metadata
Read metadata for a specific cell
notebook_read_cell_output
Read the output list of specific code cells
notebook_edit_cell_metadata
Update metadata for specific cells
notebook_clear_cell_outputs
Clear output and execution count for specific cells
notebook_clear_all_outputs
Clear output and execution counts for all code cells
notebook_move_cell
Move the cell to a different position
notebook_split_cell
Split cells at specified row number
notebook_merge_cells
Merge cells with cells that are immediately followed
notebook_validate
Verify notebook structure
notebook_get_info
Search general information
notebook_export
Export your notebook to another format
