This release is a pre-release and may not be stable for production use.
nteract
An MCP (Model Context Protocol) server that connects AI assistants to Jupyter notebooks via the nteract desktop app.
Download the nteract desktop app — you'll need it to see notebooks, collaborate with agents, and manage environments.
Looking for the old Electron-based nteract desktop app? The source is archived at nteract/archived-desktop-app. The new native app is actively developed at nteract/desktop.
Bringing Agents in the Loop
We're in the preliminary stages of hooking up the realtime system from nteract/desktop to any agent of your choice. Collaborate with agents in notebooks, render interactive elements, and explore data together.
Quick Start
Claude Code
# Stable
claude mcp add nteract -- uvx nteract
# Nightly
claude mcp add nteract-nightly -- uvx --prerelease allow nteract --nightly
Manual JSON config
{
"mcpServers": {
"nteract": {
"command": "uvx",
"args": ["nteract"]
}
}
}
That's it. Now Claude can execute Python code, create visualizations, and work with your data.
What is this?
nteract is an MCP (Model Context Protocol) server that connects AI assistants like Claude to Jupyter notebooks. It enables:
- Code execution: Run Python in a persistent kernel
- Real-time collaboration: Watch the AI work in the nteract desktop app
- Shared state: Multiple agents can work on the same notebook
- Environment management: Automatic Python environment setup
Example
Ask Claude:
"Help me visualize my log data"
Claude will:
- Connect to a notebook session
- Write and execute code
- Generate visualizations
- Show you the results
You can open the same notebook in the nteract desktop app to see changes in real-time and collaborate with the AI.
Available Tools
| Tool | Description |
|---|---|
list_active_notebooks |
List all open notebook sessions |
join_notebook |
Join an existing notebook session by ID |
open_notebook |
Open an existing .ipynb file |
create_notebook |
Create a new notebook |
save_notebook |
Save notebook to disk as .ipynb file |
create_cell |
Add a cell to the notebook (use and_run=True to execute) |
execute_cell |
Run a specific cell (returns partial results after timeout) |
run_all_cells |
Queue all code cells for execution |
set_cell |
Update a cell's source and/or type |
get_cell |
Get a cell by ID with outputs |
get_all_cells |
View all cells in the notebook |
replace_match |
Targeted literal text find-and-replace in a cell |
replace_regex |
Regex-based find-and-replace in a cell |
move_cell |
Reorder a cell within the notebook |
clear_outputs |
Clear a cell's outputs |
delete_cell |
Remove a cell from the notebook |
interrupt_kernel |
Interrupt the currently executing cell |
restart_kernel |
Restart kernel with updated dependencies |
show_notebook |
Open the notebook in the nteract desktop app (disabled with --no-show) |
add_dependency |
Add a Python package dependency |
remove_dependency |
Remove a dependency |
get_dependencies |
List current dependencies |
sync_environment |
Hot-install new deps without restart |
CLI Flags
| Flag | Description |
|---|---|
--version |
Print version and exit |
--nightly |
Connect to the nightly daemon and open nightly app |
--stable |
Connect to the stable daemon and open stable app |
--no-show |
Do not register the show_notebook tool (for headless environments) |
By default, nteract lets runtimed.default_socket_path() choose the socket. That means RUNTIMED_SOCKET_PATH wins when it is set; otherwise the package's build channel decides.
--stable and --nightly are mutually exclusive convenience overrides. When RUNTIMED_SOCKET_PATH is unset, they set it to runtimed.socket_path_for_channel(...). When RUNTIMED_SOCKET_PATH is already set, the explicit env var wins. In either case, the selected flag still controls which desktop app show_notebook tries to launch.
Architecture
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ Claude │────▶│ nteract │────▶│ runtimed │
│ (or other │ │ MCP Server │ │ daemon │
│ AI) │ │ │ │ │
└─────────────┘ └─────────────┘ └──────┬──────┘
│
┌─────────────┐ │
│ nteract │◀────────────┘
│ Desktop App │ (real-time sync)
└─────────────┘
- nteract (this package): MCP server for AI assistants
- runtimed: Low-level daemon and Python bindings (docs)
- nteract desktop: Native app for humans to collaborate with AI
Real-time Collaboration
The magic of nteract is that AI and humans share the same notebook:
- AI connects via MCP and runs code
- Human opens the same notebook in nteract desktop
- Changes sync instantly via CRDT
- Both see the same kernel state
This enables workflows like:
- AI does initial analysis, human refines
- Human writes code, AI debugs errors
- Multiple AI agents collaborate on complex tasks
Development
# Clone
git clone https://github.com/nteract/desktop
cd desktop/python/nteract
# Install dependencies
uv sync
# Run tests
uv run pytest
Related Projects
- nteract/desktop - Native desktop app
- runtimed on PyPI - Low-level Python bindings
License
BSD-3-Clause
1 maintainer
Metadata
1 maintainer
Release files for nteract 2.0.3a202603260527
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| nteract-2.0.3a202603260527.tar.gz | 79.4 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| nteract-2.0.3a202603260527-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 98.4 kB
Release files / nteract-2.0.3a202603260527.tar.gz
| Download URL | nteract-2.0.3a202603260527.tar.gz |
|---|---|
| Size | 79.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
22aa388a38d66ccf73f9a1195b1181354dd06a23f6539c481f3c736250caaad2
|
|
BLAKE2b-256 checksum How to use checksums |
33d134e4768702080fa97ac376d6d12443560a24b963bc43650e6d949020ce73
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.11.1 {"installer":{"name":"uv","version":"0.11.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / nteract-2.0.3a202603260527-py3-none-any.whl
| Download URL | nteract-2.0.3a202603260527-py3-none-any.whl |
|---|---|
| Size | 19.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
cb48521ea2814122f171677a608574203b2b2d4779a5e1f53fc30f2e02787ec0
|
|
BLAKE2b-256 checksum How to use checksums |
573fdb72e83482c5769a8c5abdb57a83d3d25cc538c88c83339c283d755f7ea6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.11.1 {"installer":{"name":"uv","version":"0.11.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for nteract 2.0.3a202603260527
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
