mcp-name: io.github.gradion-ai/ipybox ipybox is a unified execution environment for Python code, shell commands, and programmatic MCP tool calls.
> /plugin marketplace add gradion-ai/ipybox
FAQ
ipybox is a Claude Code plugin with 1 hand-picked skill for development work, indexed on Flowy. Install it with the command on its page. It includes codeact. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.
Repo: gradion-ai/ipybox
mcp-name: io.github.gradion-ai/ipybox
ipybox is a unified execution environment for Python code, shell commands, and programmatic MCP tool calls.
ipybox executes code blocks in a stateful IPython kernel. A code block can contain any combination of Python code, shell commands, and programmatic MCP tool calls. Kernels can be sandboxed with sandbox-runtime, enforcing filesystem and network restrictions at OS level.
It generates Python APIs for MCP server tools via mcpygen, and supports application-level approval of individual tool calls and shell commands during code execution. ipybox runs locally on your computer, enabling protected access to your local data and tools.
[!NOTE] Next generation ipybox
This is the next generation of ipybox, a complete rewrite. Older versions are maintained on the 0.6.x branch and can be obtained with
pip install ipybox<0.7.
| Capability | Description |
|---|---|
| Stateful execution | State persists across executions in IPython kernels |
| Unified execution | Combine Python code, shell commands, and programmatic MCP tool calls in a code block |
| Shell command execution | Run shell commands via !cmd syntax, capture output into Python variables |
| Programmatic MCP tool calls | MCP tools called via generated Python API ("code mode"), not JSON directly |
| Python tool API generation | Typed functions and Pydantic models generated from MCP tool schemas via mcpygen |
| Application-level approval | Individual approval of tool calls and shell commands during code execution |
| Lightweight sandboxing | Optional kernel isolation via Anthropic's sandbox-runtime |
| Local execution | No cloud dependencies, everything runs locally on your machine |
| Component | Description |
|---|---|
| Python SDK | Python API for building applications on ipybox |
| MCP server | ipybox as MCP server for code actions and programmatic tool calling |
| Claude Code plugin | Plugin that bundles the ipybox MCP server and a code action skill |
[!TIP] Freeact agent
Freeact is a general-purpose agent built on ipybox.
.claude/
.claude-plugin/
marketplace.json
settings.json
.dockerignore
.github/
workflows/
publish_docs.yml
publish_mcp.yml
quality.yml
release.yml
test_package.yml
test.yml
.gitignore
.pre-commit-config.yaml
.python-version
.worktreeinclude
AGENTS.md
CLAUDE.md
DEVELOPMENT.md
docker-build.sh
docker-entrypoint.sh
Dockerfile
docs/
AGENTS.md
api/
code_executor.md
kernel_manager.md
tool_executor.md
apigen.md
architecture.md
ccplugin.md
CLAUDE.md
codeexec.md
generated/
gentools/
github/
__init__.py
commits_of_top_repos/
__init__.py
api.py
impl.py
mcpparse/
__init__.py
github/
__init__.py
search_repositories.py
mcptools/
__init__.py
github/
__init__.py
list_commits.py
search_repositories_orig.py
search_repositories.py
images/
architecture-dark.png
ipybox-crop-nobg.png
logo.png
index.md
installation.md
internal/
architecture.md
README.md
testing.md
mcpserver.md
quickstart.md
sandbox.md
stylesheets/
extra.css
examples/
apigen.py
codexec.py
quickstart.py
sandbox-fetch-mcp.json
sandbox-filesystem-mcp.json
sandbox-kernel.json
sandbox.py
ipybox/
__init__.py
code_exec.py
kernel_mgr/
__init__.py
client.py
init.py
sandbox.json
server.py
mcp_server.py
utils.py
LICENSE
mkdocs.yml
plugin/
skills/
codeact/
references/
output-parsers.md
saving-codeacts.md
SKILL.md
pyproject.toml
README.md
server.json
setup_uv.sh
tasks.py
tests/
__init__.py
AGENTS.md
CLAUDE.md
integration/
__init__.py
conftest.py
mcp_server.py
sandbox.json
test_code_exec.py
test_kernel_init.py
test_kernel_mgr.py
test_mcp_server.py
test_shell_cmds.py
unit/
__init__.py
test_code_exec_helpers.py
test_kernel_gateway.py
test_kernel_init_timeout.py
test_kernel_init.py
test_rewrite_traceback.py
uv.lockยฉ 2026 Flowy ยท Free and open source
Built for Claude Code ยท Not affiliated with Anthropic