list_personal_inbox_tasks
Retrieve all personal inbox tasks from Todoist with details like content, priority, due dates, and completion status. Use this tool to view and manage your pending tasks in a structured format.
Instructions
List all personal inbox tasks from Todoist using the ##Inbox filter. Returns structured JSON data with task details including id, content, description, completion status, labels, priority, due date, and comment count.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/tools/personal-tasks.ts:118-142 (handler)Tool definition including schema and handler. The handler executes the tool logic by calling the listPersonalInboxTasks service function and returning the result as JSON text.export const listPersonalInboxTasksTool: Tool = { schema: { name: 'list_personal_inbox_tasks', description: 'List all personal inbox tasks from Todoist using the ##Inbox filter. Returns structured JSON data with task details including id, content, description, completion status, labels, priority, due date, and comment count.', inputSchema: { type: 'object', properties: {}, required: [], }, }, handler: async () => { console.error('Executing list_personal_inbox_tasks...'); const result = await listPersonalInboxTasks(); console.error('list_personal_inbox_tasks completed successfully'); return { content: [ { type: 'text', text: JSON.stringify(result, null, 2), }, ], }; }, };
- Core helper function that fetches and transforms personal inbox tasks from Todoist using the Inbox project filter.export async function listPersonalInboxTasks(): Promise<TasksResponse> { return await fetchTasksByFilter( `##${ProjectNames.INBOX} & !subtask`, 'list personal inbox tasks' ); }
- src/handlers/tool-request-handler.ts:66-87 (registration)Registration of the tool's handler in the toolsWithoutArgs registry for dispatching tool calls.const toolsWithoutArgs: Record<string, () => Promise<ToolResponse>> = { list_personal_inbox_tasks: listPersonalInboxTasksTool.handler, list_brian_inbox_per_becky_tasks: listBrianInboxPerBeckyTasksTool.handler, list_becky_inbox_per_brian_tasks: listBeckyInboxPerBrianTasksTool.handler, list_next_actions: listNextActionsTool.handler, get_brian_only_projects: getBrianOnlyProjectsTool.handler, get_brian_shared_projects: getBrianSharedProjectsTool.handler, get_becky_shared_projects: getBeckySharedProjectsTool.handler, get_inbox_projects: getInboxProjectsTool.handler, get_context_labels: getContextLabelsTool.handler, get_chores_due_today: getChoresDueTodayTool.handler, get_tasks_due_tomorrow: getTasksDueTomorrowTool.handler, get_tasks_due_this_week: getTasksDueThisWeekTool.handler, get_tickler_tasks: getTicklerTasksTool.handler, list_gtd_projects: listGtdProjectsTool.handler, get_waiting_tasks: getWaitingTasksTool.handler, get_recent_media: getRecentMediaTool.handler, get_areas_of_focus: getAreasOfFocusTool.handler, get_shopping_list: getShoppingListTool.handler, list_brian_time_sensitive_tasks: listBrianTimeSensitiveTasksTool.handler, list_becky_time_sensitive_tasks: listBeckyTimeSensitiveTasksTool.handler, };
- src/index.ts:79-117 (registration)Registration of the tool's schema in the ListTools response for tool discovery.server.setRequestHandler(ListToolsRequestSchema, async () => { return { tools: [ getTaskCommentsTool.schema, listPersonalInboxTasksTool.schema, listBrianInboxPerBeckyTasksTool.schema, listBeckyInboxPerBrianTasksTool.schema, listNextActionsTool.schema, getBrianOnlyProjectsTool.schema, getBrianSharedProjectsTool.schema, getBeckySharedProjectsTool.schema, getInboxProjectsTool.schema, createProjectLabelTool.schema, createTaskCommentTool.schema, updateTaskTool.schema, createTaskTool.schema, moveTaskTool.schema, getContextLabelsTool.schema, getTasksWithLabelTool.schema, completeTaskTool.schema, uncompleteTaskTool.schema, searchTasksTool.schema, searchTasksUsingAndTool.schema, searchTasksUsingOrTool.schema, getChoresDueTodayTool.schema, getTasksDueTomorrowTool.schema, getTasksDueThisWeekTool.schema, getTicklerTasksTool.schema, listGtdProjectsTool.schema, getWaitingTasksTool.schema, getRecentMediaTool.schema, getAreasOfFocusTool.schema, getShoppingListTool.schema, completeBeckyTaskTool.schema, listBrianTimeSensitiveTasksTool.schema, listBeckyTimeSensitiveTasksTool.schema, ], }; });
- src/tools/personal-tasks.ts:119-128 (schema)Tool schema defining name, description, and empty input schema.schema: { name: 'list_personal_inbox_tasks', description: 'List all personal inbox tasks from Todoist using the ##Inbox filter. Returns structured JSON data with task details including id, content, description, completion status, labels, priority, due date, and comment count.', inputSchema: { type: 'object', properties: {}, required: [], }, },