Todoist MCP Server

Instructions

Implementation Reference

• src/tools/workflows-tasks.ts:147-171 (handler)

  The tool handler implementation for 'list_next_actions'. It calls the helper function listNextActions() and returns the result as formatted JSON text content.
  export const listNextActionsTool: Tool = { schema: { name: 'list_next_actions', description: 'List all next actions from Todoist using the (##Next actions | ##Brian acknowledged) & !subtask 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_next_actions...'); const result = await listNextActions(); console.error('list_next_actions completed successfully'); return { content: [ { type: 'text', text: JSON.stringify(result, null, 2), }, ], }; }, };
• src/tools/workflows-tasks.ts:148-157 (schema)

  The schema definition for the 'list_next_actions' tool, specifying name, description, and empty input schema.
  schema: { name: 'list_next_actions', description: 'List all next actions from Todoist using the (##Next actions | ##Brian acknowledged) & !subtask 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: [], }, },
• src/services/tasks/task-retrieval.ts:138-143 (helper)

  The core helper function that fetches next actions tasks from Todoist using the specified filter and transforms them into structured response.
  export async function listNextActions(): Promise<TasksResponse> { return await fetchTasksByFilter( '(##Next actions | ##Brian acknowledged) & !subtask', 'list next actions' ); }
• src/handlers/tool-request-handler.ts:66-87 (registration)

  Registration of the list_next_actions tool handler in the toolsWithoutArgs registry used by 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, };
• src/index.ts:85-86 (registration)

  Registration of the tool schema in the MCP server's listTools response.
  listBeckyInboxPerBrianTasksTool.schema, listNextActionsTool.schema,