Skip to main content
The Appeeky MCP server includes eleven phone tools. Any MCP client that is connected to Appeeky can use the phones on your Mac. There is nothing extra to install: connect the client once, then share your phones from Appeeky Desktop.
Phone tools use 0 API credits. The MCP connection must use the same Appeeky account that is signed in to Appeeky Desktop.

Tools

phone_devices, phone_observe and phone_list_apps are marked as read-only tools.

How an assistant uses them

  1. phone_observe returns the element list as text and the screenshot as an image.
  2. The assistant picks an element by its number and acts, for example with phone_tap.
  3. Every action returns a fresh observation, so the assistant rarely needs to call phone_observe twice in a row.
Element numbers expire after any action. The assistant must use the numbers from the most recent observation. A tap on a button like Post, Send or Buy waits for you. The tool call stays open until you approve or deny on the Phones page of the dashboard, for up to 10 minutes. If you deny, the tool returns an error that starts with APPROVAL_DENIED: and the assistant should stop and ask you what to do. See Approvals and safety.
Some MCP clients stop waiting for a tool call after a while. If the call ends before you decide, the approval request is still open, and the tap runs when you approve it. Ask the assistant to observe the screen again to see the result.

Common parameters

Tools that take a target accept either element, or both x and y:

phone_devices

Lists the phones that are online. No parameters. Returns the devices as JSON: id, name, platform, driver, screen, and serial when known. When no phone is online it returns No phones connected. with the setup problems your Mac reported.

phone_observe

Returns two parts: a text list of the elements, one per line as [3] "Send" (button, clickable) at 512,1180, and the screenshot as an image.

phone_tap

Returns the new observation, or tap: done with observe: false.

phone_long_press

phone_swipe

Drags from one place to another. For plain scrolling, use phone_scroll.

phone_scroll

phone_type

Types into the focused text field. Tap the field first. Line breaks press Enter.

phone_key

Android supports all of them. iPhone supports home, enter, delete, lock, volume_up and volume_down.

phone_open_app

phone_list_apps

Returns the apps as JSON, each with id and name.

phone_push_media

Copies an image or video into the phone’s gallery so apps can pick it, for example when posting. Works on Android. Pass url or path. Returns Copied to <path on the phone>. It is in the gallery now.

Errors

A failed tool call returns an error result with a text message. Policy errors start with a code: Other messages describe the problem in plain words, for example No phones are online. See Troubleshooting.

Example prompts