---
id: jupyter-ai-magics
version: "2.31.7"
license: BSD 3-Clause License Copyright (c) 2023, Project Jupyter All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the… (full text in the JSON record)
license_treatment: permissive
maintenance: active
---

# jupyter-ai-magics — Jupyter AI magics Python package. Not published on NPM.

License: permissive · Maintenance: active · Downloads: 126.2K/mo

## What it is and what it does

Jupyter AI Magics is a JupyterLab extension that brings agentic AI capabilities directly into computational notebooks. It provides a native chat interface where you can interact with frontier AI agents—including Claude, Codex, GitHub Copilot, Gemini, and others—all integrated through the Agent Client Protocol. Agents are automatically detected when their dependencies are installed, so setup is as simple as installing Jupyter AI and your chosen agent.

The extension gives agents the ability to read and write files, run terminal commands, and interact with notebooks through a built-in Jupyter MCP server. A permission system lets you control agent actions—agents request approval before writing files or executing commands. You can create multiple concurrent chats, drag and drop files or notebook cells as context, and collaborate in real time with other users on the same server. The design emphasizes flexibility and extensibility: you can add custom MCP servers to give agents domain-specific tools and resources, and developers can build custom AI personas using entry points.

Use it for:

- Collaborate with AI agents to write, debug, and refactor code directly in notebooks without leaving your development environment.
- Use agents to analyze data and generate insights by giving them access to notebook cells and files through the MCP protocol.
- Build domain-specific AI assistants by registering custom MCP servers that expose specialized tools and resources to agents.
- Pair-program with frontier AI models in real time while maintaining control over file writes and command execution via the permission system.
- Integrate multiple AI agents into a single notebook session for comparative analysis or specialized task delegation.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Jupyter AI Magics provides a JupyterLab extension that integrates AI agents into computational notebooks through a chat interface, enabling agents to read files, run commands, and interact with notebooks via the Agent Client Protocol.

Yes, if you use JupyterLab and want to integrate AI agents into your notebooks. The package is actively maintained, has low install friction, carries a permissive BSD license, and supports current Python versions (3.9–3.12). It has no known vulnerabilities and offers genuine value for collaborative AI-assisted development. Install it alongside your chosen agent provider (langchain-community includes many options) to get started.

## Install

pip install jupyter-ai-magics
uv add jupyter-ai-magics
poetry add jupyter-ai-magics

## Installing jupyter-ai-magics

Before you install: Low install friction with a pure Python wheel distribution. The package is actively maintained with recent commits and sits in the top 15000 PyPI packages by download volume, indicating established adoption.

License in practice: BSD 3-Clause License permits commercial and private use with minimal restrictions; you must retain copyright notices and disclaimers in source and binary distributions.

Quickstart:

pip install jupyter-ai-magics

from jupyter_ai_magics import register_magics
register_magics()

Requires JupyterLab to be installed and running; agents are auto-detected only when their dependencies (e.g., langchain-community providers) are also installed.

Verify before relying:

- Whether the package works with JupyterLab versions prior to a specific release.
- Performance characteristics when running multiple concurrent agent chats.
- Whether custom MCP servers require additional system dependencies beyond Python packages.

## Package facts

- License: BSD 3-Clause License Copyright (c) 2023, Project Jupyter All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the… (full text in the JSON record) (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 126.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

jupyter ai agents chat, jupyterlab ai extension, notebook ai assistant, agentic ai for jupyter, claude copilot in jupyter, ai notebook integration, jupyter mcp server, jupyter-extension, ai-agents, mcp-protocol

[View on SkillFed](https://skillfed.io/packages/jupyter-ai-magics) · [View on PyPI](https://pypi.org/project/jupyter-ai-magics/)