About Jupyter Editor MCP
Jupyter Editor MCP is an MCP server published by jsamuel1 in the Developer Tools category: modify Jupyter notebooks without corrupting their structure from your AI Coding assistant.
The repository has 4 stars and 2 forks, with the last commit 8 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/jsamuel1/jupyter-editor-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Jupyter Editor MCP
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 5 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- ✓Tests presentA test suite exists in the repository.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
Releases
README
Jupyter Notebook Editor MCP Server
A Model Context Protocol (MCP) server for programmatically editing Jupyter notebooks while preserving their format and structure.
Features
- 29 specialized tools for notebook manipulation
- File-based operations - no Jupyter server required
- Format preservation - automatic validation after modifications
- Batch operations - modify multiple cells or notebooks at once
- Type-safe - full type hints for all operations
Installation
One-Click Install
From PyPI
uv tool install jupyter-editor-mcp
jupyter-editor-mcp
From Source
git clone https://github.com/jsamuel1/jupyter-editor-mcp.git
cd jupyter-editor-mcp
uv venv
uv pip install -e ".[dev]"
See INSTALL.md for detailed configuration options.
Usage
With Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"jupyter-editor": {
"command": "jupyter-editor-mcp"
}
}
}
Example Interactions
Read a notebook:
"Show me the structure of my notebook.ipynb"
Insert a cell:
"Add a markdown cell at the beginning explaining what this notebook does"
Batch operations:
"Replace all occurrences of 'old_function' with 'new_function' in all code cells"
Multi-notebook:
"Merge analysis.ipynb and visualization.ipynb into combined.ipynb"
Tool Categories
- Read Operations (4 tools): read_notebook, list_cells, get_cell, search_cells
- Cell Modification (5 tools): replace_cell, insert_cell, append_cell, delete_cell, str_replace_in_cell
- Metadata Operations (4 tools): get_metadata, update_metadata, set_kernel, list_available_kernels
- Batch Operations - Multi-Cell (6 tools): replace_cells_batch, delete_cells_batch, insert_cells_batch, search_replace_all, reorder_cells, filter_cells
- Batch Operations - Multi-Notebook (7 tools): merge_notebooks, split_notebook, apply_to_notebooks, search_notebooks, sync_metadata, extract_cells, clear_outputs
- Validation (3 tools): validate_notebook, get_notebook_info, validate_notebooks_batch
Development
# Run tests
pytest
# Run tests with coverage
pytest --cov
# Install in development mode
uv pip install -e ".[dev]"
Documentation
- docs/RESEARCH.md - Technical research and tool specifications
- docs/REQUIREMENTS.md - User stories and acceptance criteria
- docs/DESIGN.md - Architecture and API design
- CONTRIBUTING.md - Contribution guidelines
License
MIT
README fetched from the repository 5 days ago. The original is authoritative.