list_personal_inbox_tasks

Instructions

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),
          },
        ],
      };
    },
  };

• src/services/tasks/task-retrieval.ts:114-119 (helper)

  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: [],
    },
  },