Jupyter Notebook MCP Server (for Cursor)
@jbeno
About Jupyter Notebook MCP Server (for Cursor)
Model Context Protocol (MCP) server designed to allow AI agents within Cursor to interact with Jupyter Notebook (.ipynb) files
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"cursor-notebook-mcp": {
"command": "uv",
"args": [
"pip",
"install",
"cursor-notebook-mcp"
]
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
What is Jupyter Notebook MCP Server (for Cursor)?
Jupyter Notebook MCP Server (for Cursor) is a Model Context Protocol server that allows AI agents within Cursor to interact directly with Jupyter Notebook (.ipynb) files. It overcomes Cursor’s limitation (as of version 0.50.5) where the agent mode could not edit notebooks or cells. The server uses nbformat for safe notebook manipulation and nbconvert for exporting, and restricts operations to user-defined directories for security.
How to use Jupyter Notebook MCP Server (for Cursor)?
Install with pip install cursor-notebook-mcp (Python 3.10+). Then start the server manually: cursor-notebook-mcp --transport streamable-http --allow-root /path/to/notebooks --host 127.0.0.1 --port 8080. Configure Cursor by adding a "notebook_mcp" entry to ~/.cursor/mcp.json with the server URL (http://127.0.0.1:8080/mcp).
Key features of Jupyter Notebook MCP Server (for Cursor)
- Directly create, read, edit, delete, and move notebook cells
- Supports code, markdown, and raw cell types
- Export notebooks to Python, HTML, PDF, and more via nbconvert
- Restricts file operations to user‑defined allowed roots
- Provides tools for bulk cell adds, search, and outlining
- Supports multiple transport modes: stdio, Streamable HTTP (recommended), and SSE
Use cases of Jupyter Notebook MCP Server (for Cursor)
- AI agents editing notebook cells during interactive coding sessions in Cursor
- Automating notebook creation, modification, and validation from agent prompts
- Exporting notebooks to other formats (Python script, HTML, PDF) programmatically
- Navigating and searching large notebooks to find and edit specific cells
- Working with notebooks on remote SSH servers via SFTP support
FAQ from Jupyter Notebook MCP Server (for Cursor)
What limitation does this server address?
As of Cursor version 0.50.5, the agent mode could not edit Jupyter Notebook cells. This server provides MCP tools that enable direct cell manipulation.
Can this server be used with other tools besides Cursor?
Yes. Although designed for Cursor, it has no Cursor‑specific code beyond configuration instructions. It can be configured for VS Code (Insiders), Claude Code, or any MCP‑compatible agent.
What are the runtime requirements?
Python 3.10+ is required. All Python dependencies are installed automatically with the package. Optional external dependencies Pandoc and LaTeX are needed for certain nbconvert export formats (e.g., PDF).
How does the server ensure security?
The server restricts all file operations to directories specified via the --allow-root flag. This prevents the AI agent from accessing files outside the permitted paths.
What transport protocols are supported?
The server supports stdio, Streamable HTTP (recommended), and SSE (legacy) transports. Configuration for Cursor is provided for Streamable HTTP and SSE.
Frequently asked questions
What limitation does this server address?
As of Cursor version 0.50.5, the agent mode could not edit Jupyter Notebook cells. This server provides MCP tools that enable direct cell manipulation.
Can this server be used with other tools besides Cursor?
Yes. Although designed for Cursor, it has no Cursor‑specific code beyond configuration instructions. It can be configured for VS Code (Insiders), Claude Code, or any MCP‑compatible agent.
What are the runtime requirements?
Python 3.10+ is required. All Python dependencies are installed automatically with the package. Optional external dependencies Pandoc and LaTeX are needed for certain nbconvert export formats (e.g., PDF).
How does the server ensure security?
The server restricts all file operations to directories specified via the `--allow-root` flag. This prevents the AI agent from accessing files outside the permitted paths.
What transport protocols are supported?
The server supports stdio, Streamable HTTP (recommended), and SSE (legacy) transports. Configuration for Cursor is provided for Streamable HTTP and SSE.
Basic information
More Memory & Knowledge MCP servers
RAG Documentation MCP Server
hannesrudolphAn MCP server implementation that provides tools for retrieving and processing documentation through vector search, enabling AI assistants to augment their responses with relevant documentation context.
PLUR
plur-aiAI agents start every session with amnesia — you re-explain the project, repeat your preferences, and correct the same mistakes over and over. PLUR gives them a memory that persists. Your agent's corrections, preference
Tempreon
TempreonPerson-owned, portable AI memory served over MCP. Your knowledge, preferences, and decisions — captured in one assistant, available in all of them.
Memory Bank MCP Server
alioshrA Model Context Protocol (MCP) server implementation for remote memory bank management, inspired by Cline Memory Bank.
Mcp Knowledge Graph
shanehollomanMCP server enabling persistent memory for Claude through a local knowledge graph - fork focused on local development
Comments