Picocalc MCP Server

AI assistant access to PicoCalc MicroPython hardware over USB.

Local serverstdioPython

What is the Picocalc MCP server?

AI assistant access to PicoCalc MicroPython hardware over USB. That is what the picocalc mcp server brings to an AI assistant: the same capability, reachable through the Model Context Protocol rather than a separate app or dashboard.

The short version

A MicroPython firmware and script collection for the Clockwork Pi PicoCalc handheld device, powered by the Raspberry Pi Pico 2W. Features:

The tools it exposes

The server publishes 14 tools. What each one is for:

  • Drag-and — drop** .py files to upload
  • Side-by — side diff** -- click a modified file to see device vs local changes color-coded
  • REPL — - run Python on the device from the browser (30s timeout per command)
  • Eject — - safely disconnect with on-device countdown, then unplug USB
  • Connect — Select a saved profile or create a new connection (host, port, user, password)
  • Disconnect — Press ESC-ESC to exit the terminal session
  • Passwords — Always encrypted at rest with a 4-8 digit PIN via AES-128-CBC. You will be prompted to set a PIN on first save
  • App — Description
  • Tetris — Classic Tetris with 7 pieces, ghost piece, sound effects, level progression
  • Snake — Snake with high score tracking, speed levels, sound
  • ProxiScan — BLE proximity scanner, fox hunt tool with compass, signal tracking, competition timer, waypoints, antenna calibration
  • WiFiManager — WiFi scanner with VT100 UI, signal bars, channel analysis, signal monitor

Getting it running

The server ships on PyPI as picocalc-mcp, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

How it compares

Among the browser automation options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Picocalc's toolset — Drag-and, Side-by, REPL and 11 more — is a fair guide to whether it matches your workflow. It is maintained by LofiFren; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Picocalc's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Picocalc.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
Drag-anddrop** .py files to upload
Side-byside diff** -- click a modified file to see device vs local changes color-coded
REPL- run Python on the device from the browser (30s timeout per command)
Eject- safely disconnect with on-device countdown, then unplug USB
ConnectSelect a saved profile or create a new connection (host, port, user, password)
DisconnectPress **ESC-ESC** to exit the terminal session
PasswordsAlways encrypted at rest with a 4-8 digit PIN via AES-128-CBC. You will be prompted to set a PIN on first save
AppDescription
TetrisClassic Tetris with 7 pieces, ghost piece, sound effects, level progression
SnakeSnake with high score tracking, speed levels, sound
ProxiScanBLE proximity scanner, fox hunt tool with compass, signal tracking, competition timer, waypoints, antenna calibration
WiFiManagerWiFi scanner with VT100 UI, signal bars, channel analysis, signal monitor
DemoVisual display showcase: grayscale palette, bouncing boxes, scrolling gradient, device info
EditorOn-device file browser and code editor -- browse, create, edit, delete scripts without a computer

How to install the Picocalc MCP server

{
  "mcpServers": {
    "picocalc": {
      "command": "uvx",
      "args": ["picocalc-mcp"]
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Example prompts to try

  • Use Picocalc to Drag-and.
  • Use Picocalc to Side-by.
  • Use Picocalc to REPL.

Frequently asked questions

It connects Picocalc to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (Drag-and, Side-by, REPL, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Picocalc directly.