Raspberry Pi Pico ESP32

ESP32-S3 DevKitC-1 pinout

ESP32-S3-WROOM-1, 44-pin DevKitC-1, antenna at top, two USB ports at bottom, pins colored by function. GPIO number = ESP32-S3 pin used in code (MicroPython / esp32-gpio-api). Strapping: GPIO 0, 3, 45, 46. RGB LED on GPIO 38 (v1.1) or 48 (v1.0). GPIO 35-37 used by octal PSRAM (N8R8 / N16R8).

PinNameTypeFunctions
13V3Power (3V3)3.3V OUT
1GNDGround
23V3Power (3V3)3.3V OUT
2GPIO43GPIOUART0 TX
3RSTSystemEN / RESET
3GPIO44GPIOUART0 RX
4GPIO4GPIOADC1_CH3, TOUCH4
4GPIO1GPIOADC1_CH0, TOUCH1
5GPIO5GPIOADC1_CH4, TOUCH5
5GPIO2GPIOADC1_CH1, TOUCH2
6GPIO6GPIOADC1_CH5, TOUCH6
6GPIO42GPIOJTAG MTMS
7GPIO7GPIOADC1_CH6, TOUCH7
7GPIO41GPIOJTAG MTDI
8GPIO15GPIOADC2_CH4, XTAL_32K_P
8GPIO40GPIOJTAG MTDO
9GPIO16GPIOADC2_CH5, XTAL_32K_N
9GPIO39GPIOJTAG MTCK
10GPIO17GPIOUART1 TX, ADC2_CH6
10GPIO38GPIORGB LED (v1.1)
11GPIO18GPIOUART1 RX, ADC2_CH7
11GPIO37GPIOOCTAL PSRAM
12GPIO8GPIOI2C SDA, ADC1_CH7, TOUCH8
12GPIO36GPIOOCTAL PSRAM
13GPIO3GPIOADC1_CH2, TOUCH3, STRAPPING
13GPIO35GPIOOCTAL PSRAM
14GPIO46GPIOSTRAPPING
14GPIO0GPIOBOOT BUTTON
15GPIO9GPIOI2C SCL, ADC1_CH8, TOUCH9
15GPIO45GPIOSTRAPPING
16GPIO10GPIOSPI CS, ADC1_CH9, TOUCH10
16GPIO48GPIORGB LED (v1.0)
17GPIO11GPIOSPI MOSI, ADC2_CH0, TOUCH11
17GPIO47GPIO
18GPIO12GPIOSPI SCK, ADC2_CH1, TOUCH12
18GPIO21GPIO
19GPIO13GPIOSPI MISO, ADC2_CH2, TOUCH13
19GPIO20GPIOUSB D+, ADC2_CH9
20GPIO14GPIOADC2_CH3, TOUCH14
20GPIO19GPIOUSB D-, ADC2_CH8
215VVIN (5V)5V IN
21GNDGround
22GNDGround
22GNDGround

Other ESP32 boards: ESP32 DevKit V1, ESP32-C3 SuperMini, ESP32-C6 SuperMini.

Control the real world with Raspberry Pi, Pico, ESP32 & AI

ctrlPi turns your GPIOs into something you can control and monitor from anywhere - a REST API call, Apple Home, Google Home, Amazon Alexa and any other Matter ecosystem, or an AI agent. Relays, locks, lights, valves, sensors: wire it to a Pi, Pico, or ESP32, and reach it from anything.

How it works The Packages
The story

One tiny server per board.
Everything else talks to it.

It starts with an agent, a small, zero-fuss server you drop on a Raspberry Pi, a $6 Pico W, or an ESP32 from $4. It exposes every GPIO pin over a clean REST API: read, write, pulse, watch. From there, the rest of the family builds up: smart-home bridges make your pins show up in Apple Home and Google Home, an MCP server hands the keys to AI assistants like Claude, and webhooks push every change back to you in real time. Each piece is a small, standalone, MIT-licensed project, use one, or use them all.

Agents: the muscle

A small REST server on the Pi, Pico W, or ESP32 drives the pins: outputs, inputs, pull-ups, pulses with auto-revert, reversed relay logic, and webhooks on every change. Sensors too: point one at a small script, read temperature, humidity or anything else with one call, and write, run or swap those scripts over the same API. Same API across boards, clients never care which one answered.

Bridges: the control

Bridges bring your devices into Apple Home, Google Home, Amazon Alexa and any other Matter ecosystem, or any system you build yourself with the API. Lights, locks, garage doors, valves, sensors, buttons, all driven through the agents' API. Pair once, control from your phone, your watch, or your voice.

MCP: the brain

A zero-dependency Model Context Protocol server exposes the whole GPIO surface as tools. Ask Claude to scan your LAN for agents, flip a relay, pulse a pin, read a temperature sensor, or watch a door sensor, in plain language. It works with Claude Desktop, Claude Code and any other MCP client, over STDIO or HTTP.

How it works

Small pieces, one wire format

Every arrow below is plain HTTP with an Api-Key header, no hubs, no clouds required, everything on your LAN.

How ctrlPi fits together: Claude/MCP clients, Apple Home, and Google Home/Alexa talk over MCP, HAP, and Matter to ctrlpi-mcp, the HomeKit bridge and the Matter bridge; those drive the gpio-api agents over REST, and agents fire Notifications back to the bridges on every change.

Drop an agent on a board

One line install on a Pi, a Pico W or an ESP32 (MicroPython). It serves the same 16 REST endpoints on port 8314, persists pin config across reboots, and needs nothing else.

Wire your devices, config them once

Relays and sensors connect to GPIO pins. The bridges' settings form names each device, "Porch Light, type light, GPIO 17, agent garage", and the plugin configures the pins over REST automatically.

Outputs act, inputs push

Outputs do the work: switch a relay on, light a lamp, open a valve for ten minutes, then let the agent revert it by itself. Inputs report back: when a watched pin changes, a door opens, a button is pressed, the agent fires a webhook instantly. Bridges turn it into a HomeKit/Matter event.

Let the AI drive, online brain 24/7

Point Claude Desktop at ctrlpi-mcp and every agent becomes conversational: "which agents are online?", "pulse the garage door for 2 seconds", "show me the logs from shed-pico".

The packages

Ten tools, one family

Every project is standalone, MIT-licensed, and lives at github.com/ctrlpi, Node packages also ship on npm under @ctrlpi.

AGENT PYTHON

pi-gpio-api

The core REST server for Raspberry Pi A+/ B+/ 2/ 3/ 4/ 5/ Zero W/ Zero 2 W. One-liner install, API-key auth, mock mode on Mac/PC for development.

AGENT MICROPYTHON

pico-gpio-api

The same API on a $6 Raspberry Pi Pico W or Pico 2 W in MicroPython, precompiled so it boots fast and straight into serving, with safe over-the-air upgrades.

AGENT MICROPYTHON

esp32-gpio-api

The same REST API on ESP32, ESP32-C3 and ESP32-S3 with MicroPython 1.29, pre-compiled bytecode, USB installer with Wi-Fi setup.

BRIDGE MCP NODE

ctrlpi-mcp

An MCP server with 18 tools that let AI agents (e.g. Claude Desktop) control pi-gpio-api Pis, pico-gpio-api Pico Ws, or esp32-gpio-api ESP32s.

PLUGIN NODE

homebridge-ctrlpi

Already running Homebridge? One plugin, and your pins are in the Home app beside everything else. Configured from the Homebridge UI, no terminal.

BRIDGE MCP NODE

ctrlpi-matter

A Matter-over-IP bridge, the same devices in Apple Home, Google Home, Alexa, and Home Assistant at once.

TOOL PYTHON

ctrlpi-cli

A portable Python CLI with zero dependencies. Discover agents, read and write GPIO, inspect sensors, manage scripts, and manage your setup from the terminal.

TOOL NODE

ctrlpi-lab

A local browser dashboard for your ctrlPi setup. Test GPIO, sensor and script endpoints, watch webhook events, and tail agent logs, with zero dependencies.

TOOL AI MCP NODE

pico-bay

A local web app and MCP server for USB boards. Edit files, run Python, watch the console, and back up MicroPython and CircuitPython devices.

TOOL AI MCP NODE

pi-bay

A local web app and MCP server for Raspberry Pis and other SSH devices on your network. Discover them, edit files, open a remote terminal, and install the ctrlPi API.

AI & MCP

"Claude, did I give enough water to my garden this week?"

Two lines to connect Claude to every agent on your LAN.

Add to Claude Desktop

Add an MCP entry that runs npx ctrlpi-mcp, nothing to install. On first run it finds your agents.

{
  "mcpServers": {
    "ctrlpi": {
      "command": "npx",
      "args": ["-y", "ctrlpi-mcp"]
    }
  }
}

Then just ask

18 tools cover the whole surface, discovery, read, write, pulse, config, scripts, logs, restart:

  • "Which agents are online right now?"
  • "Turn on the porch light on backyard-pi."
  • "Pulse GPIO 26 for 5 minutes."
  • "Is the front door contact open?"
Early access

Stay in the loop

News and updates on packages and releases - no spam.