pico-bay — Claude Code MCP server: features and setup
pico-bay — an MCP server for Claude Code manages Raspberry Pi Pico and ESP32 boards over USB. It lets an agent work with board files and run Python code.
MIT ★ 10 updated 2026-11-06
claude mcp add pico-bay -- npx -y @ctrlpi/pico-bayWhat pico-bay does
pico-bay connects an agent to Raspberry Pi Pico and ESP32 boards running MicroPython or CircuitPython. The agent can inspect files, read and write them, rename or delete paths, and run Python files. Program output is returned to the agent.
The server reports connected boards, firmware details, and Flash and RAM usage. It can interrupt a running program, reset a board, and install MicroPython on supported models in bootloader mode. Node.js 20 or newer and a board connected over USB are required.
For an MCP client on another computer, the server can use HTTP mode. That mode has no authentication or TLS and is intended for a trusted local network; do not expose it to the internet.
What it helps with
- inspect files on a connected board
- write or remove files on a board
- run a Python file and retrieve its output
- interrupt a running program or reset a board
- install MicroPython in bootloader mode
Example prompts for the agent
- List the connected boards and show the files on the first one.
- Run
main.pyon the board and return its output. - Interrupt the program running on the board.
How to install pico-bay
Platform CLI
claude mcp add pico-bay -- npx -y @ctrlpi/pico-bayPlatform CLI
codex mcp add pico-bay -- npx -y @ctrlpi/pico-bayConfig file
{
"mcpServers": {
"pico-bay": {
"command": "npx",
"args": [
"-y",
"@ctrlpi/pico-bay"
]
}
}
}Config file
{
"servers": {
"pico-bay": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@ctrlpi/pico-bay"
]
}
}
}Platform CLI
gemini mcp add pico-bay npx -y @ctrlpi/pico-bayStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about pico-bay
How do I install pico-bay in Claude Code?
Run claude mcp add pico-bay -- npx -y @ctrlpi/pico-bay. Node.js 20 or newer is required.
What does pico-bay do?
It gives an MCP agent USB access to Raspberry Pi Pico and ESP32 boards. The agent can manage files, run Python code, interrupt programs, and reset boards.
What does pico-bay need to run?
It requires Node.js 20 or newer and a Raspberry Pi Pico or ESP32 board connected over USB. The boards must run MicroPython or CircuitPython.