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 The request stays open. Nothing is tapped yet.
observe again, find the number of that button, and tap it: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: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:Next steps
- Actions: everything an agent can do on the phone.
- Approvals and safety: what pauses and what does not.
- Troubleshooting: when the phone does not show up or an action fails.

