# pinky [Health: Active]

**Category:** 🖥️ OS Automation  
**Repository:** https://github.com/DIYgod/pinky  
**GitHub Stars:** 2091  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/pinky

## Description
Let AI use your iPhone or Android phone, with you in the loop: any MCP agent from macOS, Windows or Linux, or Pinky itself, right on the phone.

## Claude Desktop Quick Installation
No generated config for this server: it installs through its own setup steps.

The project's own setup steps (from https://github.com/DIYgod/pinky), copied verbatim. Run them in order; they are not an mcpServers config.

1. Install:

```sh
brew install --cask diygod/tap/pinky
```

2. Install:

```sh
sudo apt install ./pinky_<version>_amd64.deb
```

3. Add to Claude Code:

```sh
claude mcp add --scope user pinky -- pinkyctl mcp
```

4. Install:

```sh
make app
```

5. Install:

```sh
make app         # build/pinky/darwin-<arch>/Pinky.app and pinky-<version>-<arch>.dmg
```

6. Add to Claude Code:

```sh
claude mcp add --scope user pinky -- "$PWD/build/pinky/darwin-arm64/Pinky.app/Contents/MacOS/Pinky" mcp
```

## Documentation

## What pinky does

pinky brings phone automation to MCP agents. It can connect agents such as Claude Code, Claude Desktop, Codex, Cursor, or another MCP-capable client to a real Android phone or iPhone. The agent can work through the phone while a person watches the session, approves sensitive actions, takes control, and reviews the resulting record.

The desktop application supports macOS, Windows, and Linux. Android devices from versions 10 through 17 and iPhones running iOS 17.4 or later are supported. Android emulators and iOS Simulators can also be used in supported environments.

Pinky can additionally run tasks from its own Android or iPhone app, without a computer. Users can enter or speak a task, share content with the app, and choose among supported hosted or local models. Android includes a floating-button workflow for asking about the current screen and a hidden background screen for agent work.

## How it works

Install Pinky on the computer, connect a phone, and add it to an MCP-capable agent. Connections can use stdio or HTTP. Android setup uses USB and Pinky’s bundled adb; iPhones require a USB connection for initial setup and can subsequently work over Wi-Fi. Pinky can start Android emulators and iOS Simulators that the user has created separately.

The gateway, rather than the agent’s instructions, enforces safety decisions. Banking, wallet, and password-manager apps are hidden from agents by default, and agents cannot enter password or one-time-code fields. New agents require approval and receive only the scope granted to them.

Payments, trades, transfers, and other selected actions can wait for a person to click Allow. Safety settings can also require approval for sends, orders, deletions, calls, installations, external links, settings changes, or every step. On Android 13 and later, agent activity can use a hidden second screen while the phone’s primary screen remains available. Older Android devices and iPhones use the main screen.

## Setup and configuration

Desktop requirements include macOS 13 or later, Windows 10 or 11 on 64-bit x64, or a 64-bit Linux system with Ubuntu 20.04, Debian 11, or a newer compatible distribution, glibc 2.29 or later, and GTK 3. Android requires a USB cable; some Windows phones need a USB driver, while Linux may require USB access configuration. iPhone and iPad setup requires iOS 17.4 or later and a USB cable.

Pinky is distributed through release downloads for macOS, Windows, and Linux. macOS users can also install it with Homebrew. The Windows installer runs without administrator rights, and Linux users can install a Debian package or unpack the archive. An MCP client is required for desktop-agent use.

## Tools and capabilities

- Operate Android phones, iPhones, emulators, and simulators through an MCP agent.
- Mirror sessions so a person can observe and take control.
- Pause risky actions for approval through configurable safety rules.
- Unlock a phone from the computer after a user confirms with Touch ID, Windows Hello, or a keyring password; agents do not receive the PIN.
- Schedule tasks and notify users when a condition is met on the computer and Android.
- Record steps, screenshots, and screen video, then export runs as HTML reports stored on the computer.
- Run mobile tasks with selected models, including services from DeepSeek, Qwen, Kimi, GLM, Claude, GPT, Gemini, Ollama, and LM Studio.

## Limitations and notes

Pinky is identified as pre-alpha. Some built features, including unlocking from the computer, Android background work, recordings, export, Wi-Fi pairing, and phone-file access, are still subject to user testing. On iOS 17.4 through 26, the Pinky app can be installed on the iPhone; later iOS versions use the newer phone workflow described by the project. Windows distribution is not signed yet, so SmartScreen may display a warning. Pinky is open source under Apache-2.0 and does not require an account.

_Full upstream README: https://allmcps.com/mcp/pinky/readme_