# jupyter-mcp-server

This MCP server lets an AI agent operate Jupyter notebooks, run cells, handle several notebooks, and receive text, tables, or images.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 9
- Author: ChengJiale150
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ChengJiale150/jupyter-mcp-server
- Updated: 2025-11-01
- HTML: https://affpapa.org/en/nevibecode/mcp/jupyter-mcp-server

## What it does

jupyter-mcp-server exposes notebook tools through MCP. An agent can connect to or create a notebook, inspect its source, list cells, read their contents, insert or remove cells, replace code, and execute selected cells. It also provides a combined append-and-run action and a temporary execution path that leaves no code in the notebook.

The quick setup uses `uvx better-jupyter-mcp-server` and requires Python 3.12+ together with `uv`. A Jupyter Server must be running first; its URL and authentication token are obtained with `jupyter server list` and supplied in the agent’s rules or prompt. Image results depend on the client supporting multimodal MCP responses.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add jupyter-mcp-server -- uvx better-jupyter-mcp-server
```
uvx runs the command named after the package; if the README names another one, use uvx --from better-jupyter-mcp-server <command>

### Codex

**Platform CLI**
```bash
codex mcp add jupyter-mcp-server -- uvx better-jupyter-mcp-server
```
uvx runs the command named after the package; if the README names another one, use uvx --from better-jupyter-mcp-server <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "jupyter-mcp-server": {
            "command": "uvx",
            "args": [
                "better-jupyter-mcp-server"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from better-jupyter-mcp-server <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "jupyter-mcp-server": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "better-jupyter-mcp-server"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from better-jupyter-mcp-server <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add jupyter-mcp-server uvx better-jupyter-mcp-server
```
uvx runs the command named after the package; if the README names another one, use uvx --from better-jupyter-mcp-server <command>

## When to use it
- connect several Jupyter notebooks to an agent
- inspect and edit notebook cells
- run code and return cell output
- append executable code to a notebook
- test intermediate values without saving a cell

## Example prompts
- Connect to the project notebook and run the cell that calculates summary statistics.
- Locate the data-loading cell, replace its code, and execute it again.
- Run a temporary snippet to inspect a variable without writing it into the notebook.

## Similar
- [jupyter-notebooks](https://affpapa.org/en/nevibecode/plugins/jupyter-notebooks.md) — plugin · ★ 40451
- [jupyter-to-marimo](https://affpapa.org/en/nevibecode/skills/jupyter-to-marimo.md) — skill · 3400 installs
- [jupyter-notebook](https://affpapa.org/en/nevibecode/skills/jupyter-notebook.md) — skill · 5600 installs
- [data-analysis-jupyter](https://affpapa.org/en/nevibecode/skills/data-analysis-jupyter.md) — skill · 1500 installs
- [data-jupyter-python](https://affpapa.org/en/nevibecode/skills/data-jupyter-python.md) — skill · 865 installs
- [open-notebook](https://affpapa.org/en/nevibecode/skills/open-notebook.md) — skill · 2000 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md