Get the connection status of Phone Link (MyPhone) and basic phone info.

Returns whether the phone is connected, the phone name/model, and whether the app is running. Use this as the first tool call to verify Phone Link is available before using other tools.

Returns: { "connected": boolean, // Whether the phone is connected "status": string, // Status text from the UI "phone_name": string, // Phone model/name if detected "app_running": boolean // Whether Phone Link is running }

Error Handling:

• If Phone Link is not running, returns connected=false with an appropriate status message.

• Use phonelink_launch_app to start it first if needed.

Read SMS messages from Phone Link's Messages tab.

Two modes:

1. List conversations: Leave conversation_name empty to get a list of all visible conversations with their last message previews.

2. Read conversation: Provide a contact name to open and read messages from that specific conversation.

Args:

• conversation_name (string, optional): Contact name to open. Empty = list all conversations.

• max_messages (number): Max messages/conversations to return (1-100, default: 20).

• navigate_to_tab (boolean): Click the Messages tab first (default: true).

Returns (list mode): { "conversation_count": number, "conversations": [{ "contact": string, ... }] }

Returns (conversation mode): { "conversation": string, "message_count": number, "messages": [{ "text": string, ... }] }

Tips:

• Use list mode first to discover available conversations.

• The contact name must match what's displayed in the Phone Link UI.

Read recent call history from Phone Link's Calls tab.

Navigates to the Calls tab and scrapes the visible call list. Each entry includes the contact/number, call type (incoming/outgoing/missed), and display text.

Args:

• max_calls (number): Maximum call entries to return (1-100, default: 20).

Returns: { "call_count": number, "calls": [{ "display_text": string, // Full text shown for the call entry "call_type": "incoming" | "outgoing" | "missed" | "unknown", "automation_id": string }] }

Read phone notifications from Phone Link's Notifications panel.

Navigates to the Notifications section and scrapes all visible notification entries. Useful for checking app notifications, system alerts, and other phone notifications mirrored to PC.

Args:

• max_notifications (number): Max notifications to return (1-100, default: 30).

Returns: { "notification_count": number, "notifications": [{ "text": string, "control_type": string, ... }] }

List recent photos from Phone Link's Photos tab.

Navigates to the Photos tab and scrapes the visible photo grid. Returns metadata about each photo entry (name, bounds, type). Note: This does NOT download photos — it lists what's visible in the UI.

Args:

• max_photos (number): Maximum photo entries to return (1-100, default: 25).

Returns: { "photo_count": number, "photos": [{ "name": string, "bounds": { x, y, width, height }, ... }] }

Debug tool: dumps the Phone Link UI automation tree as JSON.

Use this to discover UI element names, automation IDs, control types, and bounding rectangles. Helpful for troubleshooting when other tools can't find expected elements.

Args:

• max_depth (number): Maximum tree depth (1-25, default: 10). Higher = more elements but slower.

• filter_control_type (string, optional): Only return elements of this type (e.g. "Text", "Button", "ListItem").

Returns: { "element_count": number, "window_name": string, "elements": [{ "Name": string, "ControlType": string, "AutomationId": string, ... }] }

Send an SMS message through Phone Link's UI.

Opens a new message, types the recipient and message text, and clicks Send. This interacts with the Phone Link UI to send a real SMS from your phone.

Args:

• recipient (string): Contact name or phone number.

• message_text (string): The message to send (max 1600 chars).

Returns: { "sent": boolean, "recipient": string, "message": string }

⚠️ WARNING: This sends a REAL SMS. Verify recipient and message before calling.

Error Handling:

• Returns sent=false with error message if any UI element can't be found.

• Common issues: Phone not connected, Messages tab not loading, UI layout changes.

Initiate a phone call through Phone Link's dial pad.

Opens the Calls tab, enters the phone number, and clicks the call button. This triggers a real phone call from your connected phone.

Args:

• phone_number (string): The number to call (include country code if needed).

Returns: { "initiated": boolean, "phone_number": string }

⚠️ WARNING: This initiates a REAL phone call. Verify the number before calling.

Launches the Phone Link app if not already running.

Uses the ms-phone: protocol handler to open Phone Link. Wait a few seconds after calling this before using other tools.

Returns: { "launched": boolean, "message": string }