Cursor MCP Server

Model Context Protocol (MCP) implementation for Jupyter notebooks to overcome limitation with Cursor

What the server does

This directory contains a Model Context Protocol (MCP) server designed to allow AI agents within Cursor to interact with Jupyter Notebook (.ipynb) files. It was created to overcome a limitation with Cursor. As of version 0.50.5, in Agent mode, the model could not edit notebooks or notebook cells in response to dialog in the AI chat pane. This provides the agent with a suite of MCP tools that allow direct notebook cell manipulation.

• 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_read_cell: Reads the source content of a specific cell
• notebook_add_cell: Adds a new code or markdown cell after a specified index

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

• 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_read_cell — Reads the source content of a specific cell
• notebook_add_cell — Adds a new code or markdown cell after a specified index
• notebook_edit_cell — Replaces the source content of a specific cell
• notebook_delete_cell — Deletes a specific cell
• notebook_change_cell_type — Changes a cell's type (code, markdown, or raw)
• notebook_duplicate_cell — Duplicates a cell multiple times (default: once)
• notebook_get_cell_count — Returns the total number of cells
• notebook_read_metadata — Reads the top-level notebook metadata

Credentials and setup notes

This project has both Python package dependencies and potentially external system dependencies for full functionality.

Recorded tools

• 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_read_cell — Reads the source content of a specific cell.
• notebook_add_cell — Adds a new code or markdown cell after a specified index.
• notebook_edit_cell — Replaces the source content of a specific cell.
• notebook_delete_cell — Deletes a specific cell.
• notebook_change_cell_type — Changes a cell's type (code, markdown, or raw).
• notebook_duplicate_cell — Duplicates a cell multiple times (default: once).
• notebook_get_cell_count — Returns the total number of cells.
• notebook_read_metadata — Reads the top-level notebook metadata.
• notebook_edit_metadata — Updates the top-level notebook metadata.
• notebook_read_cell_metadata — Reads the metadata of a specific cell.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.