mcplist
JN

Jupyter Notebook

Created 6 months ago

JupyterMCP connects Jupyter Notebook to Claude AI through the Model Context Protocol, enabling AI-assisted code execution and data analysis.

Visit Homepage
development location documentation public jupyter mcp

What is Jupyter Notebook?

connects Jupyter Notebook to Claude AI, allowing Claude to directly interact with and control Jupyter Notebooks. This integration enables AI-assisted code execution, data analysis, visualization, and more.

Documentation

JupyterMCP Documentation

Features

  • Two-way communication
  • Cell manipulation
  • Notebook management
  • Cell execution
  • Output retrieval

Installation# Prerequisites

  • Python 3.12 or newer
  • uv package manager
  • Claude AI desktop application

Setup

  1. Clone or download this repository.
  2. Create a virtual environment and install jupyter-mcp kernel.
  3. (optional) Install additional Python packages.
  4. Configure Claude desktop integration.

Usage# Starting the Connection

  1. Start your Jupyter Notebook server.
  2. Create a new Jupyter Notebook and choose the jupyter-mcp kernel.
  3. Initialize the WebSocket server in a notebook cell.
  4. Launch Claude desktop with MCP enabled.

Testing with External Client

You can test the functionality without using Claude Desktop with the included external client.

Troubleshooting

  • Connection Issues
  • Cell Execution Problems
  • WebSocket Port Conflicts

Limitations

  • Only supports Jupyter Notebook 6.x
  • Text output from cells is limited to 1500 characters

License

MIT

Server Config 

{
  "mcpServers": {
    "jupyter-notebook-server": {
      "command": "npx",
      "args": [
        "jupyter-notebook"
      ]
    }
  }
}

Links & Status

Repository: github.com
Hosted: No
Global: No
Official: No

Project Info

Hosted Featured
Created At: May 23, 2025
Updated At: Aug 07, 2025
Author: jjsantos01
Category: community
License: MIT
Tags:
development location documentation