MCP JUPYTER Server
Model Context Protocol server that exposes basic tooling for inspecting and editing Jupyter notebooks (.ipynb) from any MCP-compatible client.
Features
- Read notebook cells with optional filtering by cell type.
- Add, update, or delete cells while preserving notebook metadata.
- Get quick notebook stats (cell counts, execution metadata, format version).
- Runs over stdio so it can be wired directly into MCP clients such as Claude Desktop.
Requirements
- Node.js 18 or newer.
- Access to the
.ipynbfiles you want to work with (local file paths).
Quick start (npx)
Run directly from the repo/package without cloning:
npx -y mcp-jupyter
Installation (local checkout)
npm install
Example MCP client entry
Point your client at the built entrypoint (adjust the path to your checkout):
{
"mcpServers": {
"jupyter": {
"command": "npx",
"args": [
"-y",
"mcp-jupyter"
],
"cmd": ""
}
},
"$version": 2
}
Available tools
Position-Based Operations
list_cells- List all cells with indices and type informationget_cell_source- Get source code of specific cells by indexedit_cell_source- Edit cell content by indexinsert_cell- Insert new cells at specific positionsdelete_cell- Delete cells by index with automatic reindexing
Enhanced Operations
move_cell- Move cells between positionsconvert_cell_type- Convert between code/markdown/raw cellsbulk_edit_cells- Perform multiple operations in a single call