handle
(optional): Phone number or email to filter by
How to use it
handle is exposed by the Imessage MCP MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the handle tool becomes available to the model automatically. See the full listing for setup details and every tool this server provides.
FULL IMESSAGE MCP LISTINGOther tools in Imessage MCP (8)
chatGuid
(required): The chat GUID
endDate
(optional): ISO datetime string for end date
firstName
(required): First name to search for (e.g., 'John')
lastName
(optional): Last name to search for (e.g., 'Smith'). If omitted, searches across all name fields
limit
(optional): Maximum results (1-200, default: 100)
offset
(optional): Pagination offset (default: 0)
query
(optional): Text to search for
startDate
(optional): ISO datetime string for start date