An App and MCP Server for managing Raspberry Pi Pico and ESP32 boards with MicroPython or CircuitPython over USB.


Pico Bay brings the filesystem, the console, and AI integration into one dependency-free tool for Windows, macOS, Linux, and Raspberry Pi OS.
Supports Pico, Pico W, Pico 2, Pico 2 W, ESP32, ESP32-C3, and ESP32-S3. Browse, create, upload, and download files across connected boards.
Run any Python file as __main__, stream program output to a live console, and interrupt programs safely with Ctrl-C.
Enable HTTP MCP in the app or launch an MCP client over stdio. AI agents can list boards, manage files, run Python, and install supported firmware.
Nothing to install: open Pico Bay in Chrome, Edge or another Chromium-based browser and connect a board straight over USB. The same files, console and installs, without the MCP server.
Install official firmware directly from the app, with download, validation, installation, and reboot progress.
Raspberry Pi Pico: choose Reboot to BOOTSEL, or hold BOOTSEL while reconnecting USB. Select the red board pill and the matching Pico model.
ESP32: choose Enter download mode, scan, and select the red DOWNLOAD pill. Pico Bay identifies supported chips, checks flash security, and downloads and verifies the latest generic MicroPython build.
ESP32 installation selects Erase and initialize storage by default. Uncheck it to preserve existing files. Unsupported or protected chips cannot be installed.
Turn a connected board into a ctrlPi agent with one menu item.
Install ctrlPi API: in the top-right menu of a board running MicroPython, choose it, then enter your Wi-Fi details and, optionally, an API key and a name. Pico Bay downloads and checks the latest pico-gpio-api (Pico W, Pico 2 W) or esp32-gpio-api (any ESP32; the ESP32, ESP32-C3 and ESP32-S3 are supported), writes it to the board and resets it.
The board then answers on your network, so ctrlpi-cli, ctrlpi-lab, Apple Home through homebridge-ctrlpi and AI clients through mcp-bridge can drive its pins. On a board that already runs the agent, the form is pre-filled and its pins and sensors are kept.
Start in the browser with nothing to install, or run the app on your computer.
Online: open Pico Bay Online in Chrome, Edge or another Chromium-based browser, connect a board with a USB data cable, click Connect and pick it.
On your computer: install Node.js 20 or newer on Windows, macOS, Linux, or Raspberry Pi OS, then run:
npx pico-bay
Connect a MicroPython or CircuitPython board with a USB data cable. Open http://localhost:7426 if the browser does not open automatically. On a Raspberry Pi host, open http://PI_ADDRESS:7426 from another device on your LAN.
On Windows, startup builds the serial helper using the .NET Framework v4 C# compiler (csc.exe). ESP32 boards may also require their USB serial driver. See the setup FAQ.
For MCP setup and the full command reference, see the package documentation. Subscribe for updates below.
Connect Claude directly to your physical USB boards.
Point an MCP entry at npx pico-bay
{
"mcpServers": {
"pico-bay": {
"command": "npx",
"args": ["-y", "pico-bay", "--mcp-stdio"]
}
}
}Manage your boards, files, and firmware right from the chat:
Subscribe to our mailing list for updates on new features and device support.