List Category Transactions
list_category_transactionsRead-only
Retrieve and filter transactions for a specific budget category to track spending patterns and monitor financial activity.
Instructions
[1 API call] List transactions for a specific category
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| budget_id | No | Budget ID or 'last-used' | last-used |
| category_id | Yes | The category ID | |
| since_date | No | Only return transactions on or after this date (YYYY-MM-DD) | |
| type | No | Filter by type | |
| last_knowledge_of_server | No | Delta request token |
Implementation Reference
- src/tools/transactions.ts:318-340 (handler)Registration and handler implementation for the list_category_transactions MCP tool.
server.registerTool("list_category_transactions", { title: "List Category Transactions", description: "[1 API call] List transactions for a specific category", inputSchema: { budget_id: z.string().default("last-used").describe("Budget ID or 'last-used'"), category_id: z.string().describe("The category ID"), since_date: z.string().optional().describe("Only return transactions on or after this date (YYYY-MM-DD)"), type: z.enum(TRANSACTION_TYPES).optional().describe("Filter by type"), last_knowledge_of_server: z.number().optional().describe("Delta request token"), }, annotations: { readOnlyHint: true }, }, async ({ budget_id, category_id, since_date, type, last_knowledge_of_server }) => { try { const response = await getClient().transactions.getTransactionsByCategory( budget_id, category_id, since_date, type, last_knowledge_of_server ); const txns = response.data.transactions; if (txns.length === 0) return textResult("No transactions found for this category."); const lines = txns.map(formatTransaction); return textResult(`Category Transactions (${txns.length}):\n${lines.join("\n")}`); } catch (e: any) { return errorResult(e.message); }