mpftp

mpftp — board tools for the editor, CLI, and agents.

mpftp Connect MicroPython and CircuitPython boards from VS Code, Cursor, or the CLI, over USB or Wi-Fi: dual-pane file transfer, in-editor REPL, firmware builds and flashing, mip/circup, plus RPC and an optional browser PWA.

GitHub Repo Docs Agent guide Releases
Live Pure-Python Device

Editor session

Dual-pane file transfer beside a live serial REPL — same board session as the CLI.
mpftp — COM4 (MicroPython)

Dual-pane file transfer

Local workspace           Board
------------------        ----------------
main.py                   /boot.py
board_config.py           /main.py
lib/pydevices/            /lib/pydevices/
  displaydev.py             displaydev.mpy
  audiodev.py               audiodev.mpy

REPL & firmware

>>> import board_config
>>> board_config.display_drv.fill(0xF800)
>>> print("PyDevices OK")
PyDevices OK
>>>
$ mpftp firmware flash
[FLASHER] Writing image... 100%

Surfaces

VS Code / Cursor extension

Connect, dual-pane files, in-editor REPL, mip/circup, and a visual firmware builder — without leaving the editor.

CLI & agent RPC

python -m mpftp shares the active editor session. Agents use the CLI or a local TCP RPC; see the agent guide.

Integrations

A Claude Code plugin installs a skill that teaches the CLI, and mpftp hold keeps one REPL open across calls.

Optional browser PWA

No editor required: pip install -i https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ pydevices-mpftp, then python -m mpftp opens file transfer and the REPL in a local browser tab.

Install

A .vsix for the editor, a wheel for the CLI

mpftp is not on the VS Code Marketplace or Open VSX yet. Download mpftp-*.vsix from the latest release and run Extensions: Install from VSIX… in VS Code, Cursor or VSCodium. You also need Python with mpremote, and circup for CircuitPython packages.

Who builds and approves the signed Windows installer, and what the app sends over the network, is in the code signing policy.

New in 0.0.6 and 0.0.7

2026-09-24

Wi-Fi is a first-class connection. Over USB, Enable Wi-Fi access shows you the boot.py change, then the board appears by name in the Wi-Fi list and the REPL and file transfer run over WebREPL. On the CLI, every board command takes -d ws://HOST. Firmware builds now take a selection of modules, or a preset from micropython-pydevices, instead of every sibling folder.

Read more

Depth lives in the repository

Newcomer's guide

Entry points, who owns the board session, and the repository map.

mpftp over Wi-Fi

Setting a board up for WebREPL, and what changes when you connect without a cable.

Firmware modules

Picking modules and presets for a build.

Integrations

The Claude Code plugin, whose skill teaches the CLI.