jupyter-ai-tools
A suite of tools for AI agents in Jupyter
Decision gist · record as of 2026-08-14
Yes, if you are building AI agents that need to interact with Jupyter notebooks or Git repositories. The extension is actively maintained, has low install friction, carries a permissive BSD license, and exposes a well-designed toolkit for agent-driven automation. Install with caution if your use case requires extensive performance testing with large notebooks, as that is not documented in the fact sheet.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Jupyter Server to be running; Python 3.10 or later.
- Low friction install with three runtime dependencies (jupyter-server, jupyter-ydoc, pycrdt).
- Active maintenance with a release 29 days ago; repo is not archived and last commit was recent.
License · maintenance · safety
permissive license (permissive) — BSD 3-Clause License permits commercial and private use with attribution and liability disclaimers; no restrictions on modification or redistribution.
last release 2026-07-16 (29 days) · last repo commit 2026-07-27 · 12 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 101,840 downloads/mo, #12,910 on PyPI
Alternatives
Verify before relying
pip install jupyter_ai_tools
from jupyter_ai_tools.utils import collaborative_tool
user_info = {"name": "Alice", "color": "var(--jp-collaborator-color1)", "display_name": "Alice Smith"}
@collaborative_tool(user=user_info)
async def my_tool(file_path: str, content: str):
return f"Processed {file_path}"- Whether the collaborative_tool decorator requires additional setup beyond the decorator application shown in the excerpt.
- Performance characteristics when managing large notebooks or repositories through the toolkit.
- Compatibility with Jupyter environments other than Jupyter Server (e.g., JupyterHub, JupyterLite).
What it is and what it does
jupyter_ai_tools is a Jupyter Server extension that provides a collection of tools designed for AI agents (such as those in Jupyter AI) to programmatically interact with notebooks, files, and Git repositories. It exposes four main toolkits: file system operations (read, write, search, glob, grep, ls), notebook operations (read, add, edit, delete cells), Git operations (clone, status, log, pull, push, commit), and bash execution. The tools are compatible with OpenAI-style function calling and MCP tool schemas, making them suitable for integration with AI agents that need to modify notebooks or manage version control.
The package includes a collaborative_tool decorator that enables real-time collaboration awareness, allowing other users in the same Jupyter environment to see when an AI tool is actively working on shared notebooks. It depends on jupyter-server, jupyter-ydoc, and pycrdt for its runtime, and supports Python 3.10 through 3.14. The extension is actively maintained and installs with low friction.
Use it for
- Enable AI agents to automatically generate, edit, and organize notebook cells in response to user requests.
- Provide version control operations (commit, push, pull) to agents managing code repositories within Jupyter.
- Allow agents to search and modify files across a project using file system tools like grep and search-and-replace.
- Support collaborative notebook editing by showing other users when an AI agent is actively modifying shared notebooks.
- Execute bash commands from agents to run tests, build processes, or system utilities within the Jupyter environment.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you are building AI agents that need to interact with Jupyter notebooks or Git repositories.
The extension is actively maintained, has low install friction, carries a permissive BSD license, and exposes a well-designed toolkit for agent-driven automation. Install with caution if your use case requires extensive performance testing with large notebooks, as that is not documented in the fact sheet.
Install
jupyter-ai-tools on PyPI
Before you install
Low friction install with three runtime dependencies (jupyter-server, jupyter-ydoc, pycrdt). Active maintenance with a release 29 days ago; repo is not archived and last commit was recent.
Requires Jupyter Server to be running; Python 3.10 or later.
License in practice
BSD 3-Clause License permits commercial and private use with attribution and liability disclaimers; no restrictions on modification or redistribution.
Quickstart
pip install jupyter_ai_tools
from jupyter_ai_tools.utils import collaborative_tool
user_info = {"name": "Alice", "color": "var(--jp-collaborator-color1)", "display_name": "Alice Smith"}
@collaborative_tool(user=user_info)
async def my_tool(file_path: str, content: str):
return f"Processed {file_path}"Verify before relying
- Whether the collaborative_tool decorator requires additional setup beyond the decorator application shown in the excerpt.
- Performance characteristics when managing large notebooks or repositories through the toolkit.
- Compatibility with Jupyter environments other than Jupyter Server (e.g., JupyterHub, JupyterLite).
Package facts
| License | permissive license permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 3 packagesjupyter-serverjupyter-ydocpycrdt |
| Maintenance | Actively maintained 29 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 101,840 / month, #12,910 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Framework :: JupyterLicense :: OSI Approved :: BSD LicenseProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14 |
Evidence: jupyter_ai_tools-0.6.1-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “ai-powered notebook editing”
- jupyter-ai-toolsA Jupyter Server extension that exposes file system, notebook, Git,…
- jupyter-collaborationAdds real-time collaborative editing to JupyterLab and Jupyter…
- jupyter-collaboration-uiAdds real-time collaboration UI elements to JupyterLab and Jupyter…
Give your agent the search over MCP, or paste the wish link into any chat.
More Application Frameworks packages
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides a way to document function parameters, class attributes, return types, and variables inline using Python's `Annotated` type hint syntax instead of traditional docstrings.
Textual is a Python framework for building cross-platform user interfaces that run in the terminal or web browser using a modern, component-based API.
Install it if you're developing CLI tools, dashboards, or interactive terminal applications.
Typer builds command-line applications from Python functions using type hints, automatically generating help text, argument parsing, and shell completion.
Install it if you are building CLIs in Python.
Build and connect to Model Context Protocol servers that expose tools, resources, and prompts to LLM applications over stdio, HTTP, or SSE transports.
Install it if you need to build or connect to servers.
Werkzeug is a WSGI utility library providing request/response objects, URL routing, an interactive debugger, HTTP utilities, and a development server for building web applications.
See also jupyter-mcp-server · jupyter-ai-magics · jupyter-ai · jupyter-mcp-tools · jupyter-server-fileid · jupyterlab_notebook_awareness · jupyter-collaboration-ui · jupyter-server-documents · jupyter-server-ydoc · jupyter-server-terminals