MCPSERV.CLUB
ihrpr

Jupyter Notebook Manager

MCP Server

Programmatic control of Jupyter notebooks via MCP

Stale(50)
29stars
4views
Updated Sep 14, 2025

About

An MCP server that enables reading, editing, adding, and executing cells in Jupyter notebooks programmatically, designed for integration with Claude Desktop.

Capabilities

Resources
Access data sources
Tools
Execute functions
Prompts
Pre-built templates
Sampling
AI model interactions

Demo

The MCP Server Jupyter is a specialized Model Context Protocol server that bridges the gap between AI assistants and Jupyter notebooks. It enables developers to programmatically read, modify, and execute notebook cells directly from an AI client such as Claude Desktop. By exposing a set of intuitive tools, the server transforms notebooks into first‑class data sources and computational engines that an AI can interrogate in real time, eliminating the need for manual file handling or IDE interactions.

At its core, the server offers six high‑level tools: reading a notebook with or without outputs, retrieving the output of an individual cell, adding new cells, editing existing ones, and executing a specific cell to capture its output. Each tool requires only the notebook’s file path and, where necessary, a cell identifier or source text. This minimal interface allows an AI assistant to construct complex notebook workflows—such as generating a data analysis script, running it, and feeding the results back into the conversation—all without leaving the chat window. For developers working in data science, education, or research, this capability streamlines iterative experimentation and rapid prototyping.

The server’s integration workflow is straightforward yet powerful. Developers start a JupyterLab or Notebook session in a dedicated virtual environment, then configure Claude Desktop to launch the MCP server within that same environment. Once configured, the AI can reference notebooks by absolute path and invoke any of the six tools. Modifications made through the assistant are immediately reflected in the notebook file, though a manual reload is required to see changes in the browser. This design keeps the Jupyter instance active while allowing the AI to manipulate notebooks on the fly, making it ideal for teaching assistants that need to adjust lesson material or data scientists who want to tweak exploratory code snippets without interrupting their analysis.

Unique advantages of this MCP server include its lightweight toolset that covers the full lifecycle of notebook interaction—reading, writing, and execution—while remaining agnostic to the underlying kernel or environment. It supports both code and markdown cells, enabling dynamic generation of documentation alongside executable content. The server’s reliance on the familiar Jupyter ecosystem ensures compatibility with existing workflows, packages, and kernels, making it a versatile addition to any AI‑augmented development stack.