> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appeeky.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Phones

> Let AI agents use the real Android phones and iPhones connected to your Mac, with a human approval before anything is posted, sent or paid for.

**Phones** lets an AI agent use a real phone that is connected to your Mac. The agent sees the screen, taps, types, scrolls, opens apps and copies media into the gallery. The phone is yours and is signed in to your own accounts, so the agent can work in apps that have no API, for example to post a video to TikTok or Instagram.

A tap on a button like **Post**, **Send**, **Buy** or **Delete** does not run right away. It waits until you approve it in the dashboard.

> [!NOTE]
>
> Phone actions use **0 API credits** and need no paid plan. You need **Appeeky Desktop** running on a Mac with at least one phone connected.

> [!NOTE]
>
> The **Phones** page in the web dashboard is in private beta. If it says **Phones is in private beta**, ask the Appeeky team for access. You need this page to approve actions.

***

## How it works

```mermaid theme={"theme":{"light":"github-light","dark":"github-dark"}}
sequenceDiagram
  participant A as Agent (MCP or REST)
  participant S as Appeeky
  participant D as Appeeky Desktop on your Mac
  participant P as Your phone
  participant U as You
  A->>S: Tap element 12
  S->>D: Forward the action
  D->>D: Check the button label
  D->>S: Label is Post, so ask for approval
  S->>U: Email and card on the Phones page
  U->>S: Approve
  S->>D: Approved
  D->>P: Tap
  D->>A: New screenshot
```

1. **Appeeky Desktop connects out.** When you turn on phone sharing, Appeeky Desktop opens a connection from your Mac to Appeeky. The connection is outbound, so you don't need to make your Mac or your phone reachable from the internet.
2. **An agent sends an action.** The agent calls an MCP tool or the REST API. Appeeky sends the action to the Mac that owns the phone.
3. **Your Mac runs it.** Appeeky Desktop runs the action on the phone and sends back a fresh screenshot with numbered boxes over the elements the agent can tap.
4. **Risky taps wait for you.** If the button's label contains a word such as Post, Send or Buy, the action pauses. You get an email and a card on the **Phones** page. Nothing happens until you approve. If you don't decide within 10 minutes, the answer is no.

***

## Three ways to use a phone

| | |
| - | - |
| **MCP tools** | Any MCP client connected to Appeeky gets the `phone_*` tools. Your AI assistant decides each step. See [MCP tools](https://docs.appeeky.com/docs/phones/mcp.md). |
| **REST API** | Send one action per request from your own code. See [API reference](https://docs.appeeky.com/docs/phones/api.md). |
| **Phone agent** | Write a task in plain words. Appeeky's agent looks at the screen and takes one step at a time until the task is done. See [Phone agent](https://docs.appeeky.com/docs/phones/phone-agent.md). |

You can also watch and control the phone yourself from the **Phone** page in Appeeky Desktop. See [Appeeky Desktop](https://docs.appeeky.com/docs/phones/desktop.md).

***

## What an agent can do

| Action | What it does |
| - | - |
| Observe | Take a screenshot with a numbered list of on-screen elements |
| Tap, long press | Tap or hold an element or a point |
| Swipe, scroll | Drag between two points, or scroll the screen |
| Type, press a key | Type into the focused field, or press Home, Back, Enter, Delete and other keys |
| Open an app, list apps | Launch an app by its id, or list installed apps |
| Push media | Copy an image or video into the phone's gallery (Android) |

See [Actions](https://docs.appeeky.com/docs/phones/actions.md) for parameters and results.

***

## Requirements

| | |
| - | - |
| **Mac** | Appeeky Desktop, signed in to your Appeeky account, with **Settings → Phones → Share phones with Appeeky** turned on |
| **Android** | USB debugging on, connected by USB. Emulators work too |
| **iPhone** | Developer Mode on, connected by cable, and Xcode on the Mac |
| **Phone state** | Unlocked while agents use it, and signed in to the apps you want them to use |

See [Connect phones](https://docs.appeeky.com/docs/phones/connect-phones.md) for the full setup.

***

## Limits

| Limit | Value |
| - | - |
| Actions per phone | 30 per minute and 600 per hour |
| Approval wait | 10 minutes, then the request expires and counts as a no |
| Phone agent | 30 steps per task, task text up to 2,000 characters |
| Pushed media | Up to 512 MB per file |

***

## Next steps

* [Quickstart](https://docs.appeeky.com/docs/phones/quickstart.md): connect a phone and approve your first action.
* [Approvals and safety](https://docs.appeeky.com/docs/phones/approvals-and-safety.md): which taps pause and what the approval gate does not cover.
* [Use cases](https://docs.appeeky.com/docs/phones/use-cases.md): post a video from your own account and other flows.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.