Get Phone Messages
phonelink_get_messagesRetrieve SMS messages and conversations from Phone Link. List visible chats or read a specific contact's message history.
Instructions
Read SMS messages from Phone Link's Messages tab.
Two modes:
List conversations: Leave conversation_name empty to get a list of all visible conversations with their last message previews.
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.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "phonelink_get_messages"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| max_messages | No | Maximum number of messages/conversations to return (default: 20). | |
| navigate_to_tab | No | Whether to click the Messages tab first (default: true). Set false if already on the tab. | |
| conversation_name | No | Contact name to open a specific conversation. Leave empty to list all conversations. |