Integration · Developer tools

Connect Claude & ChatGPT to Mobilerun

Ask your AI to start a task on one of your Mobilerun cloud phones, check how it went, or look at what is on a device's screen right now. It can control a device directly with taps, swipes, text and deep links, and read the steps and screenshots of past tasks. It also works with flows, triggers, mailboxes and SMS on your numbers.

Connect Mobilerun free

Free plan, no credit card. Takes about a minute.

Try asking

“Which of my phones are ready right now?”
The AI lists your devices filtered to state ready, with their IDs, type and country.
“On the first ready phone, open the app store and check for updates to our app.”
It starts an agent task on that device with your goal in plain language and returns the task ID.
“How did that task go, and what did the agent do?”
It reads the task status, the step-by-step trajectory and the screenshots captured along the way.

What your AI can do

Agent tasks

Start AI agent tasks on a device, send follow-up instructions, follow status, steps and screenshots, and cancel a running task.

Direct device control

Tap, swipe, type text and open deep links, take screenshots, read on-screen elements and list installed apps.

Flows, mail and SMS

List and update flows, fire triggers, read flow runs, and read mailbox messages, verification codes and SMS on your numbers.

“What is on the screen of device 12 now?”
It takes a screenshot and reads the on-screen elements, so it can see what to tap next.
“Get the latest verification code sent to our test mailbox.”
It lists the one-time codes found in emails in that mailbox.
“Which flow runs failed yesterday?”
It lists flow runs filtered by status and date, and reads the steps and errors of each.

30 tools for Mobilerun

These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.

cancel_taskDeletesStop a running agent task by `task_id`. The agent stops immediately; this cannot be resumed.
fire_triggerChanges dataFire a trigger by `trigger_id` with a JSON `payload`, which runs every flow attached to it on its devices.
get_deviceGet one device by `device_id`, with its state, type, country and Android version.
get_flowGet one automation flow by `flow_id`, with its trigger, devices and settings.
get_flow_runGet one flow run by `execution_id`, with its status, steps and errors.
get_screen_elementsGet the current on-screen UI elements (accessibility tree) of a device by `device_id`, useful for finding what to tap.
get_taskGet one agent task by `task_id`, with its goal, device, status and result.
get_task_statusGet the current status of an agent task by `task_id` (e.g. running, completed, failed).
get_task_stepsGet the step-by-step trajectory of what the agent did during a task by `task_id`.
install_appChanges dataInstall an app on a device by `device_id`, identified by `package_name` or `bundle_id`.
list_device_appsList the apps installed on a device by `device_id`.
list_device_tasksList the agent tasks that ran on a device by `device_id`.
list_devicesList your cloud phones and devices, filtered by `name`, `type`, `state` (e.g. ready, stopped) or `country`. Use this to find a device ID.
list_flow_runsList flow runs (executions), filtered by `flow_id`, `trigger_id`, `status` or a date range.
list_flowsList your automation flows, filtered by `search`, `status`, `enabled` or `trigger_id`.
list_mailbox_codesList one-time verification codes found in emails in a mailbox by `mailbox_id`, optionally from one `sender`.
list_mailbox_emailsList emails received in a mailbox by `mailbox_id`, filtered by `sender` or `has_otp`.
list_mailboxesList the email inboxes (mailboxes) available to your agents.
list_task_screenshotsList the screenshots captured during an agent task by `task_id`.
list_tasksList agent tasks, filtered by `status` or `query`, newest first by default.
message_taskVisible to othersSend a follow-up instruction or answer to a running agent task by `task_id` with `message`.
open_deep_linkChanges dataOpen a deep link or URL on a device (`device_id`, `deep_link`), optionally in a specific app.
resume_deviceChanges dataResume (unpark) a stopped device by `device_id`.
start_agent_taskChanges dataStart an AI agent task on a device: describe the goal in plain language in `task` and pass `device_id`. The agent operates the phone on its own and can tap, type and submit things in apps.
stop_deviceChanges dataStop (park) a device by `device_id`. Resume it later with resume_device.
swipe_screenChanges dataSwipe on a device's screen from (`start_x`, `start_y`) to (`end_x`, `end_y`) over `duration` milliseconds, by `device_id`.
take_screenshotTake a screenshot of a device's current screen by `device_id`.
tap_screenChanges dataTap the device screen at coordinates `x`, `y` on a device by `device_id`.
type_textChanges dataType `text` into the focused field on a device by `device_id`; set `clear` to empty the field first.
update_flowChanges dataUpdate a flow by `flow_id`: name, description, devices, trigger, or turn it on or off with `enabled`. Only the fields you pass change.

Set up in three steps

1
Pick the app
Create a free PipMCP account and choose Mobilerun from the app list.
2
Paste your key
Paste your Mobilerun API key (it starts with dr_sk_). In the Mobilerun cloud dashboard open the API Keys tab, click Create API Key, give it a name and copy the key. It is shown only once.
3
Add the link to your AI
You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:
1. Click your name, then Settings › Connectors › Add custom connector.
2. Paste your link as the Remote MCP server URL.
3. Switch it on from the + menu in a chat.

Questions

What can the AI do in Mobilerun?

The AI can list and read devices, installed apps, screenshots, on-screen elements, agent tasks with their steps and screenshots, flows, flow runs, triggers, mailboxes, verification codes and SMS messages. It can start and cancel agent tasks, send messages to a running task, tap, swipe, type and open deep links on a device, fire triggers and update flows.

Does the AI see my Mobilerun credentials?

No. Your Mobilerun API key is encrypted at rest and never shown to the AI. After you save it, it is not shown again, not even to you. The AI only sees the results of the tools it calls.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on, so you can start read-only. An agent task operates the phone on its own and can tap, type and submit in apps, and a cancelled task cannot be resumed. Starting tasks, firing triggers and direct device control can require your approval before they run. Every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT go to Settings › Apps & Connectors › Advanced and turn on Developer mode, then add your PipMCP link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.

What does it cost?

PipMCP has a free plan with no credit card required. Paid plans bill per completed task. You also need your own Mobilerun account.

What is the difference between an agent task and direct control?

With run_agent_task you describe a goal in plain language and Mobilerun's agent works the phone on its own until it is done. With tap_screen, swipe_screen, type_text and open_deep_link your AI does each step itself, often after reading a screenshot or the on-screen elements.