First MicroPython MCP Server for a Handheld

PicoCalc MCP Server

Give AI coding assistants direct access to PicoCalc hardware over USB. Write code, push it, test on device, iterate -- all from the AI conversation. Now on the MCP Registry and PyPI.

PyPI version MCP Registry License Platform
Install from PyPI View on GitHub
Install
$ pip install picocalc-mcp
Add to your MCP config
{
  "mcpServers": {
    "picocalc": {
      "command": "picocalc-mcp"
    }
  }
}

Six Tools, Zero Config

Plug in USB, install the package, and your AI assistant can talk directly to the PicoCalc. No copy-pasting serial output. No switching windows.

picocalc_status

Check connection, firmware version, free RAM, and SD card space.

picocalc_exec

Run MicroPython code on the device and get stdout/stderr back.

picocalc_push

Push a file from your computer to the PicoCalc SD card or flash.

picocalc_read_file

Read any file from the device -- scripts, configs, data.

picocalc_list_files

Browse directories on the device. See file names, types, and sizes.

picocalc_reset

Soft reset the device. Re-runs boot.py and main.py.

The AI Dev Stack

Three parts that work together. The MCP server gives AI hands. The skills give it knowledge. The dashboard gives you a web UI.

1

MCP Server

Execute code, push files, check device status. The AI talks directly to the hardware over USB via the Model Context Protocol.

PyPI →
2

Claude Code Skills

Teaches AI how to build for the 320x320 display, membrane keyboard, audio PWM, GPIO pins, and flicker-free rendering.

Skills Repo →
3

Dev Dashboard

Local web UI with file manager, side-by-side diff, in-browser editor, drag-and-drop deploy, and REPL.

GitHub →

What's New

Recent highlights from the PicoCalc project.

MCP Registry -- PicoCalc is now listed on the official MCP Registry, discoverable by any MCP-compatible AI tool.
PyPI Package -- pip install picocalc-mcp installs the server and all dependencies. No cloning required.
Claude Code Skills -- Open-source skill set that teaches AI how to write correct PicoCalc apps, review code, and handle hardware.
Synth 4.0 -- Ground-up rewrite with 4 instruments, QWERTY piano keyboard, ADSR envelope, arpeggiator, and 16-step sequencer.
New Games -- Pickleball and Math Practice apps built using the MCP + Skills workflow as a real-world test.
Dashboard Upgrades -- Side-by-side diff, eject button with countdown, smart file clicks, new script templates.