Jupyter Notebook MCP Server (for Cursor)

@jbeno

Basic information

About Jupyter Notebook MCP Server

Model Context Protocol (MCP) server designed to allow AI agents within Cursor to interact with Jupyter Notebook (.ipynb) files

#jupyter #mcp#jupyter-notebook#ipynb#cursor #mcp-server #mcp-tools

Jupyter Notebook MCP Server 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"
      ]
    }
  }
}

Jupyter Notebook MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

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.

Comments

More Memory & Knowledge MCP servers

LoreKeeper RPG (lorekeeper.com)

LoreKeeper Ltd

Mess in, magic out: pour in your D&D and TTRPG notes and LoreKeeper keeps them as a private store for your world. Ask Claude or ChatGPT about it, or build a sourcebook.