notebook-editor
Provides tools for reading, writing, and executing Jupyter notebooks, including cell management (add, edit, delete) and kernel execution (start, list, shutdown, execute code/cell) via jupyter_client.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Jupyter Notebook Editor MCP Server
A local MCP server for reading, writing, and executing Jupyter notebooks. Uses jupyter_client via ZMQ to communicate directly with kernels — no Jupyter server required.
Features
Notebook File Tools
Tool | Description |
| Read notebook structure and summary |
| Get content of a specific cell by index |
| Create a new empty notebook |
| Add a cell (code/markdown/raw) |
| Edit an existing cell's content |
| Delete a cell by index |
Kernel Execution Tools
Tool | Description |
| Start a new Jupyter kernel |
| List all running kernels |
| Shutdown a running kernel |
| Execute code in a kernel |
| Execute a notebook cell and save outputs back to the file |
Related MCP server: cursor-notebook-mcp
Architecture
MCP Server (TypeScript)
│
├── notebook-file.ts — read/write .ipynb files
│
└── kernel-exec.ts — kernel lifecycle & execution
│
└── kernel_helper.py — Python long-running process
│
└── jupyter_client (ZMQ) — direct kernel communicationThe MCP server spawns a Python helper process that manages kernels via jupyter_client. Commands are sent over stdin/stdout as JSON, avoiding HTTP/CSRF issues entirely.
Setup
Prerequisites
Node.js 18+
Python 3.8+ with
jupyter_clientinstalled
pip install jupyter_clientInstall & Run
npm install
npm run dev # development (tsx)
npm run build # compile TypeScript
npm start # production (node dist/index.js)MCP Client Configuration
{
"mcpServers": {
"notebook-editor": {
"command": "npx",
"args": ["tsx", "/path/to/mcp-servers/notebook-editor/src/index.ts"]
}
}
}Usage
Execute a single cell
start_kernel(name="python3") → kernel_id
execute_cell(file_path="demo.ipynb", cell_index=0, kernel_id="<id>")
shutdown_kernel(kernel_id="<id>")Execute multiple cells with shared state
start_kernel(name="python3") → kernel_id
execute_cell(file_path="demo.ipynb", cell_index=0, kernel_id="<id>")
execute_cell(file_path="demo.ipynb", cell_index=1, kernel_id="<id>")
execute_cell(file_path="demo.ipynb", cell_index=2, kernel_id="<id>")
shutdown_kernel(kernel_id="<id>")Auto-start kernel (single cell)
execute_cell(file_path="demo.ipynb", cell_index=0)
# Kernel auto-starts and shuts down after executionDevelopment
npm install
npm run devLicense
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
MCP server for OpenAI API (chat completions, image generation, embeddings) via AceDataCloud
An MCP server that let you interact with Cycloid.io Internal Development Portal and Platform
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA Model Control Protocol (MCP) server that enables remote programmatic control of Jupyter notebooks, allowing AI assistants and applications to create, edit, and execute notebook cells via SSE protocol.-
- FlicenseNot gradedqualityDmaintenanceAn MCP server that enables AI agents to create, read, edit, and manage Jupyter Notebook files programmatically, overcoming limitations in Cursor's native notebook support.219 PyPI161-
- AlicenseAqualityDmaintenanceAI-powered MCP server for connecting and managing Jupyter Notebooks. Enables interactive code execution, multi-notebook management, and multimodal output for data analysis, visualization, and machine learning.12101 PyPI9MIT
- AlicenseBqualityCmaintenanceAn MCP server for safely inspecting, editing, and synchronizing Google Colab-compatible .ipynb notebooks through Google Drive.1628 PyPIMIT