anywidget-mcp 0.1.1

anywidget-mcp runs AnyWidgets inside AI conversations. Interact with a Python widget, then let the model respond to its current state. Connect through a host that supports MCP Apps, the Model Context Protocol extension for interactive interfaces.

• Bring existing widgets. Serve widgets from a package or reuse the ones you develop in Jupyter and marimo.
• Accept conversational input. Typed Python factories become tools that create a fresh widget for each call.
• Share selected state. Python validates interactions, and you choose which values the model can read.
• Explore large datasets. Serve query-backed viewers such as Embedding Atlas and share their current filter with the model.
• Compose interfaces. Expose several tools, return a group of widgets, or create widgets from source in a sandbox.

Try it

Requires Python 3.11+ and uv, a Python package runner:

uvx --with wigglystuff anywidget-mcp serve wigglystuff:ColorPicker --port 8010

Connect your MCP Apps host to http://127.0.0.1:8010/mcp, ask to pick a color, and change the selection. Getting started walks through this in Inspector Chat.

Use Python

Install in the environment that owns your widgets:

uv pip install anywidget-mcp wigglystuff

from anywidget_mcp import serve
from wigglystuff import ColorPicker

serve(ColorPicker, state="color")

state="color" gives the model the current color while the full widget remains interactive. Use AnyWidgetMCP to register several tools or attach() to add widgets to an existing server.

Documentation

Getting started · Write a widget · Pass input · Share state · API reference · Deployment

Experimental software. The API may change between releases.