list_personal_inbox_tasks
Retrieve and list all tasks from your Todoist inbox. Provides structured JSON data with task details including content, priority, due dates, and completion status for efficient task management.
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)Defines the MCP Tool object for 'list_personal_inbox_tasks', including its schema (name, description, inputSchema) and handler function. The handler logs execution, calls the helper function listPersonalInboxTasks(), formats the result as JSON text content, and returns it in MCP format.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), }, ], }; }, };
- src/index.ts:83-83 (schema)The tool's schema is registered in the MCP server's ListTools handler response array.listPersonalInboxTasksTool.schema,
- src/handlers/tool-request-handler.ts:66-87 (registration)Registers the 'list_personal_inbox_tasks' handler in the toolsWithoutArgs map used for dispatching no-arg tool calls in handleToolRequest.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, };
- Core helper function that retrieves personal inbox tasks from Todoist using filter '##Inbox & !subtask', leveraging the shared fetchTasksByFilter utility.export async function listPersonalInboxTasks(): Promise<TasksResponse> { return await fetchTasksByFilter( `##${ProjectNames.INBOX} & !subtask`, 'list personal inbox tasks' ); }
- src/tools/index.ts:49-49 (registration)Re-exports the listPersonalInboxTasksTool for use in other modules like handlers and index.listPersonalInboxTasksTool,