# pico-bay

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 10 repo stars
- Author: ctrlpi
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ctrlpi/pico-bay
- Updated: 2026-11-06
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/pico-bay

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add pico-bay -- npx -y @ctrlpi/pico-bay
```

### Codex

**Platform CLI**
```bash
codex mcp add pico-bay -- npx -y @ctrlpi/pico-bay
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "pico-bay": {
            "command": "npx",
            "args": [
                "-y",
                "@ctrlpi/pico-bay"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "pico-bay": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@ctrlpi/pico-bay"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add pico-bay npx -y @ctrlpi/pico-bay
```

## When to use it
- 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
- List the connected boards and show the files on the first one.
- Run `main.py` on the board and return its output.
- Interrupt the program running on the board.

## Similar
- [cwc-makers](https://affpapa.org/en/nevibecode/plugins/cwc-makers.md) — plugin · ★ 47914 repo stars
- [m5-onboard](https://affpapa.org/en/nevibecode/skills/m5-onboard.md) — skill · 2904 installs
- [gpio-baremetal](https://affpapa.org/en/nevibecode/skills/gpio-baremetal.md) — skill · 383 installs
- [picocalc-mcp](https://affpapa.org/en/nevibecode/mcp/picocalc-mcp.md) — MCP server · ★ 80 repo stars
- [rp2040-pico](https://affpapa.org/en/nevibecode/skills/rp2040-pico.md) — skill · ★ 29 repo stars
- [the-pirate-bay](https://affpapa.org/en/nevibecode/skills/the-pirate-bay.md) — skill · ★ 1988 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
