list_contacts
Retrieve and filter iMessage contacts with message counts and tier assignments to analyze communication patterns and prioritize conversations.
Instructions
List all contacts with message counts and tier assignments. Supports filtering by tier and minimum message threshold. By default, only shows contacts you've actually messaged (replied to). Use include_all to see all.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tier | No | Filter by contact tier | |
| min_messages | No | Minimum message count to include | |
| sort_by | No | Sort order (default: messages) | |
| include_all | No | Include messages from all contacts, even those you've never replied to (default: false) | |
| limit | No | Max results (default 50, max 500) |