PhonePort help

Set up PhonePort and fix what gets in the way.

Start with the five setup steps. Quick answers covers the short questions, each guide takes one task, and troubleshooting lists each problem with its cause and its fix.

In PhonePort, Menu > Help > PhonePort support opens this page.

Stuck? Email guru@graniteai.co

This page covers PhonePort 1.0.1. The guide for AI agents covers version 1.0.2, the next update. Updated November 20, 2026.

Getting started

Before you begin.

What you need

  • A 64-bit PC with Windows 11.
  • An iPhone on the same network as the PC. Windows must treat that network as Private.
  • To control the iPhone: a Bluetooth adapter that supports the Bluetooth Low Energy peripheral role, and AssistiveTouch turned on on the iPhone.

Mirroring works without that Bluetooth adapter. Control does not. PhonePort checks the adapter shortly after it starts and tells you if it cannot control the phone, so the free trial shows what your PC can do.

Install from the Microsoft Store

  1. 1Open PhonePort in the Microsoft Store and choose Free trial. The trial has every feature for 7 days.
  2. 2When it has installed, open PhonePort from the Start menu.
  3. 3The setup guide opens beside the picture the first time. Menu > Help > Setup guide brings it back.
Download from the Microsoft Store

The Microsoft Store updates PhonePort for you. Check your version and update

Set up in five steps

These are the steps of the setup guide in PhonePort, in its order. Each one ticks itself off when PhonePort sees it happen. Under each step is what you should see when it has worked, and where to go when it has not.

  1. 1

    Put this PC on your network

    Connect the PC to the same Wi-Fi or wired network as your iPhone. If Windows treats the network as Public, PhonePort says so. Click Open network settings, open the network's properties and set Network profile type to Private network, if it is a network you trust.

    You should see: The setup guide ticks this step and shows "On" with this PC's network address. PhonePort shows no notice about a public network.

    If you do not: The iPhone does not list the PC in Screen Mirroring

  2. 2

    Mirror your iPhone

    On the iPhone, open Control Center, tap Screen Mirroring and choose the name PhonePort shows. Unless you renamed it, that is your PC's name.

    You should see: The phone's screen appears in the PhonePort window, with its sound.

    If you do not: The iPhone does not list the PC in Screen Mirroring · The picture works but there is no sound

  3. 3

    Pair Bluetooth for mouse and keyboard

    On the iPhone, turn on Settings > Accessibility > Touch > AssistiveTouch. Click Pair Bluetooth in PhonePort. Then on the iPhone open Settings > Bluetooth and tap this PC under Other Devices. Pairing stays open for two minutes.

    You should see: The setup guide ticks this step and says "Paired", with the phone's name when it knows it.

    If you do not: The PC is not under Other Devices on the iPhone, or pairing does not finish · PhonePort says the Bluetooth adapter cannot control the phone

  4. 4

    Choose your phone

    Click the phone button at the left of the toolbar and choose the iPhone you are mirroring. Until its dot is green, PhonePort is still waiting for that phone. You choose each phone once.

    You should see: The phone button shows the phone's name with a green dot, and the setup guide says "Connected to the phone you are mirroring".

    If you do not: Clicks and keys do nothing on the phone, or the pointer does not move

  5. 5

    Take control

    Click a button in the phone picture, then type. Click any other window to give the keyboard back to Windows.

    You should see: While you control the phone, the status bar reads "Controlling iPhone - click elsewhere to return".

    If you do not: Clicks and keys do nothing on the phone, or the pointer does not move · Typing produces nothing, or the wrong characters

After the first time

PhonePort remembers each iPhone you pair. Start Screen Mirroring on the iPhone and click inside the picture. These three guides are the ones to read next.

The PhonePort window with the setup guide open beside the mirrored iPhone. All five steps are ticked: Put this PC on your network, Mirror your iPhone, Pair Bluetooth for mouse and keyboard, Choose your phone, Take control.
The setup guide beside the picture. Each step ticks itself off as it happens.

Quick answers

Short questions, short answers.

How do I stop?
To stop control, click any other window. To stop mirroring, open Control Center on the iPhone, tap Screen Mirroring, then tap Stop Mirroring. Disconnect in the phone button's menu turns Bluetooth control off until you choose the phone again. Stop an AI agent
What does the dot on the phone button mean?
Green means the phone is connected and is the one on screen, so your clicks reach it. No dot, or a dot of another color, means PhonePort is still waiting: for a phone to pair, for you to choose one, or for its Bluetooth to connect. Pair Bluetooth and control the phone
Does the iPhone need a cable or an app?
No. The picture comes over AirPlay and the mouse and keyboard go over Bluetooth. You install nothing on the iPhone.
Where do screenshots and recordings go?
Screenshots go to Pictures\PhonePort and recordings to Videos\PhonePort. Menu > Capture opens either folder. Take a screenshot or record
Which version do I have?
Menu > Help > About PhonePort shows it. The Microsoft Store updates PhonePort for you. Check your version and update
Can I use an iPad or a Mac?
An iPad or a Mac can mirror to PhonePort, so you can watch it. Control has been tested with iPhones only.
Can I play a video with an app's cast button?
No. PhonePort does not play videos that an app sends with its cast button. It shows what Screen Mirroring sends.
Can I type in another language, or use keyboard shortcuts?
No. Typing is US ASCII: letters, digits, punctuation, Enter, Backspace, Tab and the arrow keys. Ctrl+V is the exception: it types text you copied on the PC. Type and paste
Do I pay again for a second PC?
No. The purchase belongs to your Microsoft account. Use it on another PC
Does PhonePort send my screen anywhere?
No. The picture, your clicks and your typing stay between your PC and your iPhone, and PhonePort sends nothing to us. If you connect an AI agent, its host receives pictures of the phone's screen. PhonePort privacy policy
Can an AI agent use the phone?
From version 1.0.2, yes. An agent host such as Claude Code or Codex gets the phone as eight tools and can work in the background while you use the PC. You connect your own agent. Let an AI agent use the phone

How-to guides

One task at a time.

Mirror an iPhone

  1. 1Put the iPhone and the PC on the same network, and open PhonePort.
  2. 2The window shows "Ready to mirror" and the name to look for.
  3. 3On the iPhone, open Control Center and tap Screen Mirroring.
  4. 4Choose the name PhonePort shows. The phone's screen and sound appear in the window.
  • To stop, open Control Center on the iPhone, tap Screen Mirroring, then tap Stop Mirroring.
  • An iPad or a Mac mirrors the same way, from Screen Mirroring in its Control Center. They can be watched, not controlled.
  • A device that starts Screen Mirroring takes over from the one on screen.
The PhonePort window on a Windows PC showing an iPhone running Calculator, with 128 times 4 equals 512 on screen. The status bar reads "Controlling iPhone - click elsewhere to return".
The iPhone's Calculator, tapped from the PC with the mouse. The status bar says the PC is controlling the iPhone.

Pair Bluetooth and control the phone

  1. 1On the iPhone, turn on Settings > Accessibility > Touch > AssistiveTouch.
  2. 2In PhonePort, click the phone button at the left of the toolbar. It reads Pair Bluetooth until a phone is paired.
  3. 3On the iPhone, open the main Settings > Bluetooth screen and tap the PC under Other Devices. Pair from this screen, not only from the AssistiveTouch device list.
  4. 4Click the phone button again and choose the iPhone you are mirroring. Wait for its dot to turn green.
  5. 5Click inside the phone picture to tap. The status bar reads "Controlling iPhone - click elsewhere to return". Drag with the left button held to scroll a list, or use the mouse wheel.
  6. 6Click another Windows app to use the PC again.
  • Pairing stays open for two minutes after you click Pair Bluetooth. Click the phone button to open it again.
  • Disconnect in the phone button's menu turns Bluetooth control off until you choose the phone again.
  • The PC's Bluetooth name can differ from the name it shows in Screen Mirroring.
The iPhone's AssistiveTouch settings page seen in the PhonePort window, with the AssistiveTouch switch turned on.
AssistiveTouch turned on in the iPhone's settings. The pointer needs it.

Set up the Home button

Pair Bluetooth first. This is a one-time setting on the iPhone.

  1. 1On the iPhone, open Settings > Accessibility > Touch > AssistiveTouch > Devices, then your PC, then Customize Additional Buttons.
  2. 2Click Home in PhonePort's toolbar.
  3. 3On the iPhone, assign the detected Button 2 to Home.
  • From then on, the Home button or a right-click inside the phone picture goes to the Home Screen.

Type and paste

  1. 1Click a text field in the phone picture. With no field selected, Space and Enter press whatever control is selected on the phone.
  2. 2Type on the PC keyboard. Letters, digits, punctuation, Enter, Backspace, Tab and the arrow keys are sent.
  3. 3To paste, copy text on the PC, click the phone picture and press Ctrl+V. PhonePort types up to 1,024 characters, including tabs and new lines.
  • Typing is US ASCII only. Other languages, other Unicode text and keyboard shortcuts are not sent.
  • PhonePort reads the clipboard only when you press Ctrl+V with the phone picture selected.
The PhonePort window showing the iPhone's Search with the word Calculator typed in the search field and the results below it.
A search on the iPhone, typed with the PC keyboard.

Take a screenshot or record

  1. 1Start Screen Mirroring so the phone is on screen.
  2. 2Press F8, or click Screenshot. PhonePort saves a PNG at the phone's own size in Pictures\PhonePort and copies it to the clipboard.
  3. 3Press F9, or click Record, to start a recording. Press it again to stop. The MP4, with the phone's sound, is saved in Videos\PhonePort.
  4. 4Open either folder from Menu > Capture > Open screenshots folder or Open recordings folder.
  • A recording is finished only when you stop it or close PhonePort normally.
  • A new file starts if the phone rotates.
  • Windows N editions need the Media Feature Pack to record.
The PhonePort window while recording. The Record button has turned into a red Stop button and the status bar shows REC 0:03.
Recording. The Record button reads Stop and the status bar counts the time.

Full screen and always on top

  1. 1Press F11 or Alt+Enter, or click Full screen. The buttons and the status bar hide.
  2. 2Press Escape to leave full screen.
  3. 3To keep the window above other windows, open Menu > View > Always on top.
  4. 4To size the window to the phone picture, choose Menu > View > Fit window to video.
  • The Menu button, the Alt key and a right-click outside the phone picture all open the menu.

Use more than one iPhone

  1. 1Pair each iPhone as in the pairing guide.
  2. 2Mirror each one once and choose it from the phone button. PhonePort remembers which phone belongs to which mirror.
  3. 3To switch, start Screen Mirroring on the other iPhone. It takes over the picture, and control follows it.
  • While the mirroring phone's Bluetooth connects, the phone button reads "Waiting for iPhone…".
  • In the phone list, a phone chosen for another mirror is marked "(a different iPhone)". If every phone is marked that way, the button reads "Pair this iPhone": pair the phone on screen first.
  • An iPhone that joins a different network counts as a new phone and needs choosing once more.

Check your version and update

The Microsoft Store updates PhonePort for you. Use these steps to check by hand.

  1. 1In PhonePort, open Menu > Help > About PhonePort. The first line shows the version, for example PhonePort 1.0.1.
  2. 2To look for an update, open the Microsoft Store and check for updates under Downloads or in your Library.
  3. 3When the update has installed, open PhonePort and read the version again.
  • Version 1.0.1 fixed clicks and typing that stopped working after a mirror ended while the iPhone was locked.

Use iosctl from a terminal

iosctl is a command-line helper for scripts and desktop agents. You do not need it to use PhonePort.

  1. 1Start PhonePort from the Start menu, pair the phone and set up the Home button.
  2. 2Open a terminal. The Store install puts iosctl on the command path, so it works from any folder.
  3. 3Run iosctl --help for the list of commands, and iosctl --doctor to check the setup. --doctor sends no input to the phone.
iosctl --help
iosctl --doctor
iosctl --list
  • Commands take screenshots of the phone, tap, type, drag and go Home. Typing follows the same US ASCII rules.
  • Use the input commands only where your agent environment allows desktop input.
  • In version 1.0.1, each input command first brings the PhonePort window to the front. From version 1.0.2, input runs in the background.
  • From version 1.0.2, iosctl --mcp also hands the phone to an AI agent. The AI agents section below covers it.

AI agents

Let an AI agent use the phone.

From version 1.0.2, PhonePort includes an MCP server. An AI agent can then see the iPhone's screen and tap, swipe, type and go Home on it, in the background while you keep working. PhonePort does not include an AI agent. You connect your own: an agent host that speaks the Model Context Protocol (MCP), such as Claude Code, Codex, Claude Desktop or Cursor.

Version 1.0.1 does not have the MCP server. Menu > Help > About PhonePort shows your version. Check your version and update

The agent uses your real phone

An agent acts on your iPhone with your accounts signed in. It can pick the wrong spot, and what it taps happens for real. You decide what you let it do. Watch it work before you leave it alone.

PhonePort tells the agent to ask you before a step that sends a message, pays, deletes something or changes a setting. Whether it asks is up to the agent.

Before you start

  • PhonePort is mirroring the iPhone, and you can tap and type on it with the mouse and keyboard.
  • The phone button shows a green dot for the phone on screen.
  • The Home button is set up. Without it, the agent cannot go Home.
  • Your agent host is installed and works.

Set up in five stepsSet up the Home button

From a mirrored phone to a first tap

Follow the six steps in order. Under each step is what you should see when it has worked, and where to go when it has not.

  1. 1

    Check your version

    In PhonePort, open Menu > Help > About PhonePort.

    You should see: The first line shows PhonePort 1.0.2 or a later version.

    If you do not: The agent host cannot start PhonePort, or iosctl is not recognized

  2. 2

    Check the setup from a terminal

    Open PowerShell or Windows Terminal and run the line below. It sends nothing to the phone.

    iosctl --doctor

    You should see: One line of text with "code" set to "ready". "idle_image" is fine too: it means the phone's screen is still.

    If you do not: The agent host cannot start PhonePort, or iosctl is not recognized · The status tool says PhonePort is not ready

  3. 3

    Add PhonePort to your agent host

    Use the lines for your host under "Setup lines for each agent host" below. In Claude Code, that is the line below, run in a terminal. If the host was already open, start it again so it starts the server.

    claude mcp add phoneport -- iosctl --mcp

    You should see: The host lists a server named phoneport. In Claude Code, claude mcp list shows it as connected.

    If you do not: The agent host cannot start PhonePort, or iosctl is not recognized

  4. 4

    Ask the agent to check the phone

    Ask, for example: "Use phoneport_status and tell me what it says." The status tool sends nothing to the phone.

    You should see: The status result says "Ready. Take a screenshot, act once, then read the picture the action returns." On a still screen it says "Ready. The screen is still, so the last picture is kept; an input tool wakes the stream before it acts."

    If you do not: The status tool says PhonePort is not ready

  5. 5

    Ask for a screenshot

    Ask the agent to take a screenshot of the phone and tell you what is on it.

    You should see: The agent describes the screen that the PhonePort window shows.

    If you do not: The agent says the picture is old, or that no new picture arrived · The status tool says PhonePort is not ready

  6. 6

    Give it one harmless task

    Ask, for example: "Go to the Home Screen and open Calculator." Leave the PhonePort window open while the agent works. It can sit behind other windows. Do not minimize it.

    You should see: Calculator opens in the PhonePort window, and the agent describes the picture its last step returned.

    If you do not: An agent or iosctl reports that someone is using the phone · An agent or iosctl reports that PhonePort is minimized or hidden · Home from the agent does nothing

Setup lines for each agent host

Every host starts the same program: the command iosctl with the argument --mcp. The lines below follow each host's own documentation, read on November 20, 2026.

Claude Code

  1. 1Run the first line in a terminal. It adds PhonePort for the folder you run it in.
  2. 2To have PhonePort in every folder, use the second line instead.
  3. 3claude mcp list shows whether the server connected.
claude mcp add phoneport -- iosctl --mcp
claude mcp add --scope user phoneport -- iosctl --mcp

Claude Code documentation on MCP

Codex

  1. 1Run the first line in a terminal.
  2. 2Or add the last three lines to config.toml in the .codex folder in your home folder. The Codex CLI and the IDE extension share that file.
codex mcp add phoneport -- iosctl --mcp

[mcp_servers.phoneport]
command = "iosctl"
args = ["--mcp"]

Codex documentation on MCP

Claude Desktop

  1. 1Open Settings, then Developer, and click Edit Config. That opens claude_desktop_config.json.
  2. 2Add the JSON below, save the file, then quit Claude Desktop completely and start it again.
{
  "mcpServers": {
    "phoneport": { "command": "iosctl", "args": ["--mcp"] }
  }
}

If the file already lists other servers, add the phoneport line inside the "mcpServers" that is there.

MCP documentation: connect to local MCP servers

Cursor

  1. 1Put the JSON below in mcp.json in the .cursor folder in your home folder, for every project. For one project only, put it in .cursor/mcp.json inside that project.
{
  "mcpServers": {
    "phoneport": { "command": "iosctl", "args": ["--mcp"] }
  }
}

If the file already lists other servers, add the phoneport line inside the "mcpServers" that is there.

Cursor documentation on MCP

Another MCP host

  1. 1Add a local server that the host starts itself, with the command iosctl and the argument --mcp.
  2. 2A host that reads a JSON file takes them as below. Where that file is depends on the host, so check its documentation.
{
  "mcpServers": {
    "phoneport": { "command": "iosctl", "args": ["--mcp"] }
  }
}

If the file already lists other servers, add the phoneport line inside the "mcpServers" that is there.

Tested with Claude Code and Codex, on one iPhone model. Claude Desktop and Cursor take the same command and have not been tested with PhonePort.

What the agent can and cannot do

  • It sees the phone only through pictures. The iPhone gives PhonePort no list of its buttons or text, so the agent finds each target by looking, as a person does, and it can pick the wrong spot.
  • It has eight tools: status, screenshot, tap, swipe, type, key, Home and batch. A batch runs several inputs in one call.
  • A swipe scrolls a list, goes back when it starts at the left edge, and as a fast flick moves between Home Screen pages.
  • The keys are Enter, Tab, Backspace, Space and the four arrow keys.
  • Each input returns the picture taken after it, by default 0.7 seconds later. A changed picture shows that the screen changed. It does not prove the step did what the agent meant.
  • Typing is US ASCII only, up to 1,024 characters at a time, into a text field with a visible cursor. Accented letters, other alphabets and emoji are refused. The iPhone's Calculator ignores typed digits, so the agent taps its keys.
  • Home needs AssistiveTouch Button 2 mapped to Home on the iPhone, the one-time setting in the Home button guide.
  • It cannot use the phone while the PhonePort window is minimized or hidden. Behind other windows is fine.
  • Nothing is retried. After an error that may have sent input, the agent is told to look before it acts again.

Set up the Home button

Take the phone back, or stop the agent

  • While the agent works, you can keep working in other programs. It does not use the PC's pointer or keyboard.
  • To take the phone back, click PhonePort's title bar. A click inside the phone picture also taps the phone.
  • While PhonePort is the front window and you have used the mouse or keyboard in the last minute, the agent's input is refused and nothing is sent. A mouse button held down on the PhonePort window refuses it too.
  • To hand the phone back, click another window. The agent can act again once another window is in front, or a minute after you stop using the mouse and keyboard.
  • While the agent acts, moving your pointer across the phone picture also moves the phone's pointer.
  • To stop the agent, stop it in its host. To cut it off from the phone, end Screen Mirroring on the iPhone or close PhonePort.

What leaves your PC

  • Pictures of the phone's screen go to the agent host you connected, and from there to its AI model. They show whatever is on the phone, private information included.
  • What that host and its AI service do with the pictures is up to them and their terms.
  • PhonePort sends nothing to us. The MCP server talks to the host over standard input and output, and nothing listens on the network.

PhonePort privacy policy

Troubleshooting

Each problem with its cause and its fix.

Find the line that matches what you see, then try its fixes in order.

The iPhone does not list the PC in Screen Mirroring

PhonePort says
On a public network, PhonePort names the network and says Windows treats it "as a public network, so your iPhone cannot find this PC there."
Cause
Windows treats the network as Public, the iPhone and the PC are on different networks, or the network stops devices from reaching each other. The Store version sets up Windows Firewall for private networks only, and Windows 11 marks new Wi-Fi networks as Public.
Fix
  1. 1Put the iPhone and the PC on the same network.
  2. 2If PhonePort says the network is Public, click Open network settings, open the network's properties and set Network profile type to Private network, if you trust the network.
  3. 3Only one PhonePort runs at a time. Look for an open PhonePort window before you start another.
  4. 4PhonePort follows network changes and should appear within a few seconds of the network coming back. If it still does not, choose Menu > Receiver > Restart AirPlay service.

PhonePort says the Bluetooth adapter cannot control the phone

PhonePort says
"This PC's Bluetooth adapter cannot act as a keyboard and mouse. Mirroring still works." or "No Bluetooth adapter found. Mirroring works; phone control needs one."
Cause
To act as a keyboard and mouse, the adapter must support the Bluetooth Low Energy peripheral role. Some adapters do not. The second message means Windows found no Bluetooth adapter, or Bluetooth is turned off.
Fix
  1. 1For "No Bluetooth adapter found", turn Bluetooth on in Windows, or add a Bluetooth adapter.
  2. 2For "cannot act as a keyboard and mouse", use a Bluetooth adapter that supports the peripheral role.
  3. 3Mirroring, screenshots and recording keep working in the meantime.

The PC is not under Other Devices on the iPhone, or pairing does not finish

PhonePort says
"Pairing is open for two minutes: on the iPhone, open Settings > Bluetooth and tap this PC" and, later, "Pairing closed after two minutes. Click the phone button to open it again."
Cause
PhonePort keeps pairing open for two minutes after you click Pair Bluetooth. The iPhone lists the PC under its Bluetooth name, which can differ from the name in Screen Mirroring.
Fix
  1. 1Click the phone button in PhonePort to open pairing again.
  2. 2On the iPhone, open the main Settings > Bluetooth screen, wait for the PC under Other Devices and tap it.
  3. 3Check that Settings > Accessibility > Touch > AssistiveTouch is on.
  4. 4If PhonePort says the Bluetooth adapter cannot act as a keyboard and mouse, pairing cannot work with that adapter.

Clicks and keys do nothing on the phone, or the pointer does not move

PhonePort says
"The selected iPhone is asleep. Wake it, or choose the phone that is on screen." Or: "Bluetooth connected; mirror the selected iPhone". Or: "Phone disconnected. Waiting for the saved phone." Or: "Input was canceled before it was sent. Click the phone picture to try again." Or: "Input took too long to send and was dropped. Click the phone picture to try again."
Cause
AssistiveTouch is off, the phone was paired only from the AssistiveTouch device list, the iPhone is asleep, its Bluetooth has dropped, or PhonePort has a different paired iPhone selected than the one on screen.
Fix
  1. 1Turn on Settings > Accessibility > Touch > AssistiveTouch on the iPhone.
  2. 2Pair the PC from the iPhone's main Settings > Bluetooth screen.
  3. 3Open the phone button's menu and choose the phone that is mirroring. Wait for the green dot. PhonePort remembers the choice.
  4. 4Wake the iPhone and click inside the picture again.
  5. 5For "Phone disconnected", check that the iPhone's Bluetooth is on and the phone is near the PC. PhonePort selects it again when it returns.
  6. 6If the status bar says "Mirroring is paused", go to the next problem on this page.
  7. 7If control never comes back, choose Disconnect in the phone button's menu and pair again. If that fails, remove the PC from the iPhone's Bluetooth settings and pair it fresh.

The status bar says mirroring is paused

PhonePort says
"Mirroring is paused. Unlock the iPhone to continue."
Cause
A locked iPhone pauses mirroring, and no click or key reaches it until it is unlocked. PhonePort 1.0.0 could keep showing this after the phone was unlocked, when an earlier mirror had ended while the phone was locked. Version 1.0.1 fixes that.
Fix
  1. 1Unlock the iPhone.
  2. 2If the message stays while the phone is unlocked, lock the iPhone and unlock it again, or close PhonePort and open it again.
  3. 3Check that you have version 1.0.1 or later in Menu > Help > About PhonePort. To update, open the Microsoft Store and check for updates under Downloads or in your Library.

Typing produces nothing, or the wrong characters

PhonePort says
"Paste rejected: use up to 1,024 US ASCII characters, tabs or newlines."
Cause
No text field is selected on the phone, or the text uses characters outside US ASCII. PhonePort types letters, digits, punctuation, Enter, Backspace, Tab and the arrow keys only.
Fix
  1. 1Click a text field in the phone picture first.
  2. 2Type or paste plain US ASCII text. Accented letters, other alphabets, emoji and keyboard shortcuts are not sent.
  3. 3Keep a paste to 1,024 characters or fewer.
  4. 4The iPhone's Calculator ignores digits typed on the PC keyboard. Tap its keys with the mouse instead.

The agent host cannot start PhonePort, or iosctl is not recognized

Cause
The MCP server is part of iosctl from version 1.0.2, so version 1.0.1 cannot start it. A terminal or an agent host opened before PhonePort was installed may not find iosctl, and the iosctl command can be turned off in Windows settings.
Fix
  1. 1Check that Menu > Help > About PhonePort shows 1.0.2 or later. To update, open the Microsoft Store and check for updates under Downloads or in your Library.
  2. 2Open a new terminal and run iosctl --doctor. If Windows does not recognize it, open Settings > Apps > Advanced app settings > App execution aliases and check that phoneport and iosctl are both on.
  3. 3Start the agent host again so it starts the server. Quit Claude Desktop completely before you start it again.
  4. 4In Claude Code, claude mcp list shows whether the server connected.
  5. 5If the host still cannot find iosctl, run (Get-Command iosctl).Source in PowerShell and use the path it prints as the command. In a JSON file, write each backslash in that path twice.

The status tool says PhonePort is not ready

PhonePort says
ready_for_input is false. The code names what is missing, and next says what to do.
Cause
A step before the agent is not finished: PhonePort, Screen Mirroring or Bluetooth control. The status tool sends nothing to the phone, so the agent can run it again at any time.
Fix
  1. 1If the next step starts "No PhonePort receiver is running.", open PhonePort from the Start menu.
  2. 2If the code is not_mirroring: on the iPhone, open Control Center, tap Screen Mirroring and choose the name PhonePort shows.
  3. 3If the code is mirror_paused: unlock the iPhone and resume Screen Mirroring.
  4. 4If the code is no_picture: wait for the first picture. If it stays blank, stop Screen Mirroring and start it again.
  5. 5If the code is control_not_ready: turn on AssistiveTouch, pair the PC from the iPhone's Settings > Bluetooth, then choose the mirrored phone from the phone button in PhonePort.
  6. 6If the code is control_status_stale: wait a moment and ask again. If it stays, let the agent finish, then close PhonePort and open it again.
  7. 7If the code is input_busy: an earlier input is still being sent. Wait, and have the agent look at the phone before it acts again.
  8. 8If the code is frame_interface_unavailable: close PhonePort and open it again from the Start menu.

An agent or iosctl reports that someone is using the phone

PhonePort says
"The PhonePort window is in front and the mouse or keyboard was used in the last minute: someone is using the phone. Input stopped without replay" Or: "A mouse button is pressed on the PhonePort window: someone is using the phone. Input stopped without replay"
Cause
From version 1.0.2, the person at the PC comes first. While PhonePort is the front window and you used the mouse or keyboard in the last minute, or while a mouse button is held on the PhonePort window, input from an agent or a script is refused. This is also how you take the phone back from an agent.
Fix
  1. 1To let the agent go on, click another window, or leave the mouse and keyboard alone for a minute.
  2. 2Ask the agent to look at the phone before it acts again. Part of a longer action may have reached the phone before it stopped.
  3. 3To stop the agent for good, stop it in its own program, or end Screen Mirroring on the iPhone.

An agent or iosctl reports that PhonePort is minimized or hidden

PhonePort says
"PhonePort is minimized; restore its window, which does not need to be in front" Or: "PhonePort's window is hidden; show it, which does not need to be in front"
Cause
From version 1.0.2, input from an agent or a script goes to the PhonePort window in the background. Windows gives no focus to a minimized or hidden window, and PhonePort turns phone control on only with focus. Nothing was sent to the phone.
Fix
  1. 1Restore the PhonePort window from the taskbar.
  2. 2Leave it open behind your other windows. It does not need to be in front.
  3. 3Ask the agent to try again.

An agent or iosctl reports "Windows denied focus"

PhonePort says
"Windows denied focus; click PhonePort and try a new action"
Cause
iosctl tried to bring the PhonePort window to the front before an input, and Windows refused because you were working in another window. Version 1.0.1 always brings the window to the front. From version 1.0.2 it does so only with --foreground or --keep-focus. Nothing was sent to the phone.
Fix
  1. 1Click the PhonePort window, then let the agent or the script act again.
  2. 2From version 1.0.2, input goes to the window in the background. Remove --foreground and --keep-focus from the command, or from the arguments in your agent host's settings.
  3. 3Menu > Help > About PhonePort shows your version.

The agent says the picture is old, or that no new picture arrived

PhonePort says
"The picture is [number] ms old: the screen is still, or the stream has stalled. An input tool wakes the stream before it acts." Or: "No new picture arrived after the input. The screen did not change, or the stream has stalled."
Cause
A still iPhone screen sends no new pictures, so the last one gets older. That is normal. Before it acts, an input tool moves the phone's pointer without pressing anything, so that new pictures arrive.
Fix
  1. 1On a still screen, let the agent go on.
  2. 2If the picture in the PhonePort window has stopped too, check that the iPhone is unlocked and still mirroring.
  3. 3Ask the agent to run the status tool. It names the next step.

Home from the agent does nothing

Cause
The agent's Home works like a right-click inside the phone picture. It needs AssistiveTouch Button 2 mapped to Home on the iPhone, a one-time setting. Without it, the picture does not change.
Fix
  1. 1Set up the Home button as in the guide on this page.
  2. 2Check that the Home button in PhonePort's toolbar goes to the Home Screen, then ask the agent again.

The agent cannot type some text

PhonePort says
"text accepts 1 to 1,024 US ASCII characters, tab and newline. Nothing was typed."
Cause
PhonePort types US ASCII only: letters, digits, punctuation, tab and new line. Accented letters, other alphabets and emoji are refused, and so is text longer than 1,024 characters.
Fix
  1. 1Ask for the text in plain US ASCII, or type that part yourself on the iPhone.
  2. 2Split longer text into parts of 1,024 characters or fewer.
  3. 3If typed text goes nowhere, the agent has to tap the text field first and check that a cursor shows.

The agent reports that another command is controlling the phone

PhonePort says
"Another iosctl command is controlling this receiver; observe before a new command" Or: "Receiver is processing input; observe before starting another batch"
Cause
One command at a time can send input to PhonePort. A second agent, a script or another session of the same host is sending input at the same moment, or an earlier input is still being sent.
Fix
  1. 1Let one agent or script use the phone at a time. Stop the others in their own programs.
  2. 2Ask the agent to look at the phone before it acts again.

The agent reports that the picture area changed size

PhonePort says
"PhonePort's picture area changed size during input; observe again"
Cause
The PhonePort window changed size while the agent was acting, and the input stopped.
Fix
  1. 1Leave the PhonePort window at one size while the agent works.
  2. 2Ask the agent to take a new screenshot before it acts again. Part of the action may have reached the phone.

The agent reports that Windows refused to deliver input

PhonePort says
"Windows refused to deliver input to PhonePort, which may be running as administrator; outcome unknown, do not replay"
Cause
Windows blocks input from a normal program to a program that runs as administrator. PhonePort may be running as administrator while the agent host is not.
Fix
  1. 1Close PhonePort and open it again from the Start menu, without Run as administrator.
  2. 2Ask the agent to look at the phone before it acts again. Part of the action may have reached it.

The agent reports an error about its own call

PhonePort says
"Fix the arguments and call again. Nothing was sent to the phone."
Cause
The agent called a tool with a missing or wrong value, such as a point outside the screenshot. The server refused the call before anything reached the phone.
Fix
  1. 1You do not need to do anything on the phone. The agent can correct the call itself.
  2. 2If it keeps happening, ask the agent to take a new screenshot and use points from that picture.

The picture works but there is no sound

Cause
PhonePort plays the phone's sound on the Windows default playback device. If that device is muted, turned down or not the one you are listening to, you hear nothing.
Fix
  1. 1Check the Windows default playback device and its volume. PhonePort moves the sound when the default device changes, for example when you plug in headphones.
  2. 2Turn up the volume on the iPhone.
  3. 3If there is still no sound, send us the log. It records when sound starts arriving from the phone and how loud it is.

The picture went black after a graphics driver update or reset

PhonePort says
"The graphics device was reset, so mirroring stopped. Start Screen Mirroring again on your device."
Cause
When the graphics device is reset or removed, for example by a driver update, the mirroring session ends and PhonePort rebuilds its video.
Fix
  1. 1On the iPhone, start Screen Mirroring again and choose the PC.

PhonePort still says trial after you bought it

Cause
Windows has not refreshed the app's Store license yet, or the Store is signed in with a different Microsoft account from the one that bought it.
Fix
  1. 1Sign in to the Microsoft Store with the account that bought PhonePort.
  2. 2Check your order history on your Microsoft account to confirm the purchase went through.
  3. 3Update PhonePort: open the Microsoft Store and check for updates under Downloads or in your Library.
  4. 4If you bought on the Store page while PhonePort was open, close PhonePort completely and start it again. Buying from PhonePort's own panel needs no restart.
  5. 5Keep the PC online so Windows can refresh the license.
  6. 6If the order shows in your history and the app still says trial, email guru@graniteai.co with the log and what the app shows. Do not send card or payment details.

The trial ended

PhonePort says
"Your free trial has ended"
Cause
The 7-day trial is over. Mirroring and Bluetooth control stay off until PhonePort is bought.
Fix
  1. 1Click Buy in Microsoft Store on the panel. Buying there turns mirroring and control back on without a restart.
  2. 2If the trial had already ended, Windows may offer the purchase when you start PhonePort.
  3. 3If PhonePort runs as administrator, Buy is hidden. Start it without administrator rights to buy.
  4. 4Screenshots and recordings you saved stay in your Pictures and Videos folders.

Where the log and crash reports are, and how to send them

Cause
PhonePort writes a log, debug.txt, and saves a crash report if it stops unexpectedly. It keeps the five newest crash reports. Nothing is uploaded automatically.
Fix
  1. 1In PhonePort, choose Menu > Receiver > Open log folder.
  2. 2Attach debug.txt. If PhonePort stopped unexpectedly, also attach the newest .dmp file from the crashes folder.
  3. 3Email them to guru@graniteai.co with a few lines on what you did and what you saw, your iPhone model and your Windows version.
  4. 4Read the log before you send it. It shows device names, network addresses and file names. A crash report can also hold recently typed text, so send one only if you are comfortable with that.

Trial, purchase and refunds

Microsoft runs the Store side.

Trial and price

The Microsoft Store runs a 7-day free trial with every feature.

After it, PhonePort is a one-time purchase: US$29.99 in the US. Other markets show their own price in the Store. There is no subscription.

Microsoft takes the payment, so we do not receive your card or payment details.

Use it on another PC

The purchase belongs to your Microsoft account. On the other PC, sign in to the Microsoft Store with the same account, open Library and install PhonePort.

Refunds

Microsoft, not GraniteAi, decides and issues refunds for Store purchases, under Microsoft's own refund policy. We cannot refund a Store purchase ourselves.

Microsoft's pages, read on 13 November 2026, say a refund request is made from the order history on your Microsoft account where online requests are available, and that digital items such as apps are generally not refundable unless the offer or the law that applies to you says otherwise. Check Microsoft's pages before you rely on this summary.

If PhonePort is not working, write to guru@graniteai.co first. Many problems are setup problems we can fix. Writing to us does not stop you from asking Microsoft for a refund.

Contact

Write to us.

Email us with what you did and what you saw. These details save a round of questions:

  • The exact words in PhonePort's status bar or on its panel.
  • Your PhonePort version, from Menu > Help > About PhonePort.
  • Your iPhone model and your Windows version.
  • The log, if you can attach it.

guru@graniteai.co

AirPlay, iPhone, iPad and Mac are trademarks of Apple Inc. PhonePort is not affiliated with or endorsed by Apple. PhonePort is published by GraniteAi, LLC.

PhonePort privacy policyPhonePort help