jupyter-notebook-mcp
Author: jjsantos01
Description: A Model Context Protocol (MCP) server that lets Claude AI remotely read, edit and execute Jupyter Notebook (6.x) sessions via a WebSocket bridge.
Stars: 87
Forks: 18
License: MIT License
Category: Open Source
Overview
Installation
1. Prerequisites
• Python 3.9+ and pip installed
• Jupyter Notebook or JupyterLab already available on the system
2. Clone the repository
git clone https://github.com/jjsantos01/jupyter-notebook-mcp.git
cd jupyter-notebook-mcp3. Create and activate a virtual environment (recommended)
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate4. Install Python dependencies
pip install -r requirements.txt If no requirements.txt is provided, install Jupyter and any listed packages manually.
5. Enable the MCP notebook extension (if applicable)
jupyter nbextension install src/extension --user
jupyter nbextension enable mcp_extension/main --user Adjust the path/extension-name to match the code in the repo.
6. Start Jupyter and test
jupyter notebook Open one of the sample notebooks in the repo and confirm that the MCP toolbar or menu entries appear.
Optional: Installing system-wide with pip
pip install git+https://github.com/jjsantos01/jupyter-notebook-mcp.gitLicense: MIT License
Updated 7/30/2025