Jupyter MCP Server for Claude Desktop
About
Jupyter MCP Server Jupyter MCP Server is an implementation of the Model Context Protocol (MCP) server that enables interaction with Jupyter notebooks running in any JupyterLab environment, including your local JupyterLab instance
Explore
- Provides an MCP server interface for Jupyter notebooks.
- Supports real-time collaboration via JupyterLab.
- Integrates smoothly with Claude Desktop (macOS, Windows, Linux).
- Programmatically add and execute code or markdown cells in notebooks.
---
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Jupyter MCP Server for Claude DesktopCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Ensure you have the following installed:
- JupyterLab (version 4.4.1)
- jupyter-collaboration (version 4.0.2)
- ipykernel
- datalayer_pycrdt (version 0.12.15)
pip install jupyterlab==4.4.1 jupyter-collaboration==4.0.2 ipykernel
pip uninstall -y pycrdt datalayer_pycrdt
pip install datalayer_pycrdt==0.12.15
---
{
"mcpServers": {
"jupyter": {
"command": "docker",
"args": [
"run", "-i", "--rm", "-e", "SERVER_URL", "-e", "TOKEN", "-e", "NOTEBOOK_PATH",
"datalayer/jupyter-mcp-server:latest"
],
"env": {
"SERVER_URL": "http://host.docker.internal:8888",
"TOKEN": "MY_TOKEN",
"NOTEBOOK_PATH": "notebook.ipynb"
}
}
}
}
{
"mcpServers": {
"jupyter": {
"command": "docker",
"args": [
"run", "-i", "--rm", "-e", "SERVER_URL", "-e", "TOKEN", "-e", "NOTEBOOK_PATH", "--network=host",
"datalayer/jupyter-mcp-server:latest"
],
"env": {
"SERVER_URL": "http://localhost:8888",
"TOKEN": "MY_TOKEN",
"NOTEBOOK_PATH": "notebook.ipynb"
}
}
}
}
> Make sure SERVER_URL and TOKEN match your JupyterLab setup. NOTEBOOK_PATH is relative to the directory where JupyterLab is started.
---
npx -y @smithery/cli install @datalayer/jupyter-mcp-server --client claude
---
add_execute_code_cell
Add and execute a code cell in a notebook
add_markdown_cell
Add a markdown cell in a notebook
| Tool | Description | Input Parameter | Output |
|-------------------------|-------------------------------------------|----------------------|-----------------|
| add_execute_code_cell | Add and execute a code cell in a notebook | cell_content (str) | Cell output |
| add_markdown_cell | Add a markdown cell in a notebook | cell_content (str) | Success message |
---
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"jupyter mcp server for claude desktop": {
"Integrating-the-Jupyter-server-with-claude-desktop-uisng-the-powerful-model-context-protocol": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@datalayer/jupyter-mcp-server",
"--client",
"claude"
]
}
}
}
}McpServers
{
"Integrating-the-Jupyter-server-with-claude-desktop-uisng-the-powerful-model-context-protocol": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@datalayer/jupyter-mcp-server",
"--client",
"claude"
]
}
}An implementation of the Model Context Protocol (MCP) server that enables interaction with Jupyter notebooks running in any JupyterLab environment, including local instances. Designed for seamless integration with Claude Desktop across macOS, Windows, and Linux.
---
🚀 Features
- Provides an MCP server interface for Jupyter notebooks.
- Supports real-time collaboration via JupyterLab.
- Integrates smoothly with Claude Desktop (macOS, Windows, Linux).
- Programmatically add and execute code or markdown cells in notebooks.
---
📦 Getting Started
✅ Prerequisites
Ensure you have the following installed:
- JupyterLab (version 4.4.1)
- jupyter-collaboration (version 4.0.2)
- ipykernel
- datalayer_pycrdt (version 0.12.15)
🛠 Installation
pip install jupyterlab==4.4.1 jupyter-collaboration==4.0.2 ipykernel
pip uninstall -y pycrdt datalayer_pycrdt
pip install datalayer_pycrdt==0.12.15
---
▶️ Starting JupyterLab
jupyter lab --port 8888 --IdentityProvider.token MY_TOKEN --ip 0.0.0.0
Alternatively, you can use:
make jupyterlab
> --ip 0.0.0.0 allows access from the MCP server running inside Docker.
---
💻 Integration with Claude Desktop
Claude Desktop is available on macOS and Windows. Linux users can use an unofficial build script via Nix.
🔧 Configuration (macOS / Windows)
{
"mcpServers": {
"jupyter": {
"command": "docker",
"args": [
"run", "-i", "--rm", "-e", "SERVER_URL", "-e", "TOKEN", "-e", "NOTEBOOK_PATH",
"datalayer/jupyter-mcp-server:latest"
],
"env": {
"SERVER_URL": "http://host.docker.internal:8888",
"TOKEN": "MY_TOKEN",
"NOTEBOOK_PATH": "notebook.ipynb"
}
}
}
}
🔧 Configuration (Linux)
{
"mcpServers": {
"jupyter": {
"command": "docker",
"args": [
"run", "-i", "--rm", "-e", "SERVER_URL", "-e", "TOKEN", "-e", "NOTEBOOK_PATH", "--network=host",
"datalayer/jupyter-mcp-server:latest"
],
"env": {
"SERVER_URL": "http://localhost:8888",
"TOKEN": "MY_TOKEN",
"NOTEBOOK_PATH": "notebook.ipynb"
}
}
}
}
> Make sure SERVER_URL and TOKEN match your JupyterLab setup. NOTEBOOK_PATH is relative to the directory where JupyterLab is started.
---
🛠 Available Tools
| Tool | Description | Input Parameter | Output |
|-------------------------|-------------------------------------------|----------------------|-----------------|
| add_execute_code_cell | Add and execute a code cell in a notebook | cell_content (str) | Cell output |
| add_markdown_cell | Add a markdown cell in a notebook | cell_content (str) | Success message |
---
🐳 Building the Docker Image
make build-docker
---
📦 Installation via Smithery
npx -y @smithery/cli install @datalayer/jupyter-mcp-server --client claude
---
📄 License
See the repository for license details.
---
🔗 Resources
- Official Repository: datalayer/jupyter-mcp-server
- MCP Protocol Documentation: modelcontextprotocol.io
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
