get-messages
Retrieve multiple messages from Zulip workspaces with filtering, pagination, and search. Use this tool to browse conversations, locate specific content, or access message history efficiently.
Instructions
š BULK RETRIEVAL: Get multiple messages with filtering, pagination, and search. Use this to browse conversations, search for content, or get message history. Returns array of messages with basic details.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| anchor | No | Starting point: message ID, 'newest', 'oldest', or 'first_unread' | |
| message_id | No | Get specific message by ID instead of using anchor/num parameters | |
| narrow | No | Filters: [['stream', 'channel-name'], ['topic', 'topic-name'], ['sender', 'email'], ['search', 'query']] | |
| num_after | No | Number of messages after anchor (max 1000) | |
| num_before | No | Number of messages before anchor (max 1000) |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"anchor": {
"anyOf": [
{
"type": "number"
},
{
"enum": [
"newest",
"oldest",
"first_unread"
],
"type": "string"
}
],
"description": "Starting point: message ID, 'newest', 'oldest', or 'first_unread'"
},
"message_id": {
"description": "Get specific message by ID instead of using anchor/num parameters",
"type": "number"
},
"narrow": {
"description": "Filters: [['stream', 'channel-name'], ['topic', 'topic-name'], ['sender', 'email'], ['search', 'query']]",
"items": {
"items": {
"type": "string"
},
"type": "array"
},
"type": "array"
},
"num_after": {
"description": "Number of messages after anchor (max 1000)",
"maximum": 1000,
"type": "number"
},
"num_before": {
"description": "Number of messages before anchor (max 1000)",
"maximum": 1000,
"type": "number"
}
},
"type": "object"
}