list_threads
Retrieve conversation threads for an inbox, grouping related emails by reply chains or subject matching. Returns newest threads first with pagination support.
Instructions
List conversation threads for an inbox. Threads group related emails by In-Reply-To/References headers or subject matching. Returns newest threads first.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| inbox_id | Yes | Inbox ID (e.g. ibx_...) | |
| limit | No | Max threads to return (default: 20, max: 50) | |
| cursor | No | Pagination cursor from previous response |
Implementation Reference
- src/index.ts:296-296 (handler)The actual implementation of the list_threads tool calls the inbox's listThreads method.
const result = await inbox.listThreads({ limit, cursor }); - src/index.ts:283-294 (registration)The list_threads tool is registered here with its input schema and handler function.
server.registerTool('list_threads', { title: 'List Threads', description: 'List conversation threads for an inbox. ' + 'Threads group related emails by In-Reply-To/References headers or subject matching. ' + 'Returns newest threads first.', inputSchema: { inbox_id: z.string().describe('Inbox ID (e.g. ibx_...)'), limit: z.number().optional().describe('Max threads to return (default: 20, max: 50)'), cursor: z.string().optional().describe('Pagination cursor from previous response'), }, }, async ({ inbox_id, limit, cursor }) => {