list_messages
Retrieve compact message and activity cards for a workspace, newest first, including sender, subject, preview, seen state, and attachments. Fetch full bodies separately; reading does not mark as seen.
Instructions
List the messages (and optionally the activity log) in a workspace — the portal's Activity tab. Returns compact cards (sender, subject, preview, seen state, attachments), newest first; call get_message for a full body. Reading does NOT mark anything as seen.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"workspace_id": "<workspace_id>"
},
"name": "list_messages"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | "messages" (default): emails and portal messages. "activity": everything else — meetings scheduled, files signed, payments, reminders, AI recaps. "all": both. | |
| limit | No | Max items to return (default 50). | |
| origin | No | Portal origin (e.g. https://<vendor>.hbportal.co). Optional when only one session is active. | |
| workspace_id | Yes | The workspace _id (from list_projects, or .workspace._id on any workspace_file). |