MCP Jupyter Complete

A server for Jupyter notebook manipulation with position-based operations and VS Code integration.

A comprehensive Model Context Protocol (MCP) server for Jupyter notebook manipulation with position-based operations and VS Code integration.

- list_cells- List all cells with indices and type information
- get_cell_source- Get source code of specific cells by index
- edit_cell_source- Edit cell content by index
- insert_cell- Insert new cells at specific positions
- delete_cell- Delete cells by index with automatic reindexing

- move_cell- Move cells between positions
- convert_cell_type- Convert between code/markdown/raw cells
- bulk_edit_cells- Perform multiple operations in a single call

- trigger_vscode_reload- Force VS Code to reload notebook files
- File watcher support for automatic reloading
- VS Code workspace and settings generation
- Extension recommendations for optimal Jupyter experience

git clone https://github.com/tofunori/mcp-jupyter-complete.git cd mcp-jupyter-complete

Add to your~/.claude.jsonconfiguration:

{ "mcpServers": { "jupyter-complete": { "command": "node", "args": ["/path/to/mcp-jupyter-complete/src/index.js"] } } }

{ "mcpServers": { "jupyter-complete": { "command": "mcp-jupyter-complete" } } }

// List all cells await mcp.call("list_cells", { notebook_path: "/path/to/notebook.ipynb" }); // Get cell content await mcp.call("get_cell_source", { notebook_path: "/path/to/notebook.ipynb", cell_index: 0 }); // Edit a cell await mcp.call("edit_cell_source", { notebook_path: "/path/to/notebook.ipynb", cell_index: 1, new_source: "print('Hello World!')" });

// Insert a new markdown cell await mcp.call("insert_cell", { notebook_path: "/path/to/notebook.ipynb", position: 2, cell_type: "markdown", source: "# New Section\\n\\nThis is a new markdown cell." }); // Move a cell await mcp.call("move_cell", { notebook_path: "/path/to/notebook.ipynb", from_index: 3, to_index: 1 }); // Bulk operations await mcp.call("bulk_edit_cells", { notebook_path: "/path/to/notebook.ipynb", operations: [ { type: "edit", cell_index: 0, new_source: "# Updated title" }, { type: "convert", cell_index: 1, new_type: "markdown" } ] });

// Trigger VS Code reload await mcp.call("trigger_vscode_reload", { notebook_path: "/path/to/notebook.ipynb" });

- Python
- Jupyter
- Jupyter Keymap
- Jupyter Renderers

Configure auto-reload:Add to VS Code settings:

{ "files.watcherExclude": { "/.ipynb_checkpoints/": true }, "notebook.diffEditor.ignoreTrimWhitespace": false }

Use with Claude Code:When using with Claude Code, notebook changes made via MCP will automatically trigger VS Code to prompt for reload.

- code- Python/executable code cells
- markdown- Markdown text cells
- raw- Raw text cells

The server provides detailed error messages for:

- Invalid cell indices
- File read/write permissions
- Malformed notebook JSON
- Invalid cell type conversions
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests if applicable
- Submit a pull request

MIT License - seeLICENSEfile for details.

Extentos is a multi-vendor development platform for adding smart-glasses capabilities to existing iOS and Android apps. The simplest analogy is Stripe for smart glasses