Skip to main content
This guide takes you from nothing to a tap that waited for your approval. It uses an Android phone because it needs the least setup. For an iPhone, follow Connect phones first and come back at step 3.
You need a Mac with Appeeky Desktop and an Appeeky account. To call the API you also need an API key. See Authentication. The API key must belong to the same account you use in Appeeky Desktop.

Set it up

1

Turn on phone sharing

Open Appeeky Desktop and sign in. Go to Settings → Phones and turn on Share phones with Appeeky. The badge next to it changes to Connected.
2

Connect the phone

On the Android phone, turn on Developer options → USB debugging. Connect it to the Mac with a USB cable and tap Allow on the phone. Keep the phone unlocked.
3

Check that Appeeky sees it

Open /dashboard/phones in the web dashboard. Under Connected you see your Mac with an online badge and the phone below it.You can run the same check with the API:
4

Look at the screen

Ask for an observation. It returns a screenshot and a numbered list of the elements on screen.
With one phone connected you can leave out device. The description field lists each element with its number, for example [12] "Send" (button, clickable) at 512,1180.
5

Trigger an approval

On the phone, open any screen that has a button labelled Send, Post or Share, for example a draft message to yourself. Run observe again, find the number of that button, and tap it:
The request stays open. Nothing is tapped yet.
6

Approve it

Open /dashboard/phones. Under Waiting for you there is a card with the screenshot, the button the agent wants to tap and the reason. Choose Approve. The tap runs on the phone and the curl request returns the new screen.You also get an email with a link to this page.
Element numbers are only valid for the latest observation. After any action, use the numbers from the screenshot that the action returned.

Use it from an AI assistant

If your assistant is connected to the Appeeky MCP server, it already has the phone tools. Ask in plain words:
The assistant calls phone_observe and reads the screen. See MCP tools.

Give the phone agent a task

Open the Phone page in Appeeky Desktop, type a task under Agent and choose Run. Or call the API:
See Phone agent.

Next steps