Use the Speak AI MCP server tool get_chat_messages to get full message history for
conversations.
What does it do?
Get full message history for conversations. Can filter by promptId for a specific conversation, by media/folder, or search across all chat messages. Returns questions, answers, references, and metadata.
Parameters
get_chat_messages takes 6 parameters, all of them optional.
| Name | Type | Required | Description |
|---|---|---|---|
promptId |
string | No | Filter to a specific conversation by its ID |
folderId |
string | No | Filter messages by folder ID |
mediaIds |
string | No | Filter by media IDs (comma-separated) |
query |
string | No | Search text in prompts and answers |
page |
number | No | Page number for pagination (0-based, default: 0) |
pageSize |
number | No | Results per page (default: 25, max: 500) |
Behaviour
The Speak AI MCP server publishes these behaviour hints for get_chat_messages.
- Only reads data. Does not modify your workspace.
- Does not delete or overwrite existing data.
- Repeating an identical call is safe.
- Stays inside Speak AI. Does not reach other systems.
Related
- Ask AI Chat lists the rest of the Ask AI Chat category.
- Tool reference lists every Speak AI MCP server tool.
- MCP server covers setup, supported clients, and what agents can do once connected.