Todoist MCP Server

Instructions

Implementation Reference

• src/tools/task-queries.ts:43-67 (handler)

  MCP Tool definition including the handler function that executes the tool logic by calling getTasksDueTomorrow() and formatting the result as JSON text content.

  export const getTasksDueTomorrowTool: Tool = {
    schema: {
      name: 'get_tasks_due_tomorrow',
      description:
        'Get all tasks due tomorrow from Todoist, excluding various project categories like Tickler, Chores, and baby-related projects. Returns structured JSON data with task details including id, content, due date, project id, and labels.',
      inputSchema: {
        type: 'object',
        properties: {},
        required: [],
      },
    },
    handler: async () => {
      console.error('Executing get_tasks_due_tomorrow...');
      const result = await getTasksDueTomorrow();
      console.error('get_tasks_due_tomorrow completed successfully');
      return {
        content: [
          {
            type: 'text',
            text: JSON.stringify(result, null, 2),
          },
        ],
      };
    },
  };

• src/tools/task-queries.ts:44-53 (schema)

  Input schema definition for the get_tasks_due_tomorrow tool (no input parameters required).

  schema: {
    name: 'get_tasks_due_tomorrow',
    description:
      'Get all tasks due tomorrow from Todoist, excluding various project categories like Tickler, Chores, and baby-related projects. Returns structured JSON data with task details including id, content, due date, project id, and labels.',
    inputSchema: {
      type: 'object',
      properties: {},
      required: [],
    },
  },

• src/handlers/tool-request-handler.ts:66-87 (registration)

  Registration of the get_tasks_due_tomorrow tool handler in the toolsWithoutArgs registry map used for handling 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/services/tasks/task-retrieval.ts:78-80 (helper)

  Core helper function that fetches raw Todoist tasks due tomorrow using the predefined TOMORROW_FILTER and generic fetchRawTasksByFilter utility.

  export async function getTasksDueTomorrow(): Promise<TodoistTask[]> {
    return await fetchRawTasksByFilter(TOMORROW_FILTER, 'get tasks due tomorrow');
  }

• src/index.ts:104-115 (registration)

  The tool schema is registered in the listTools response for MCP protocol compliance.

    getTasksDueTomorrowTool.schema,
    getTasksDueThisWeekTool.schema,
    getTicklerTasksTool.schema,
    listGtdProjectsTool.schema,
    getWaitingTasksTool.schema,
    getRecentMediaTool.schema,
    getAreasOfFocusTool.schema,
    getShoppingListTool.schema,
    completeBeckyTaskTool.schema,
    listBrianTimeSensitiveTasksTool.schema,
    listBeckyTimeSensitiveTasksTool.schema,
  ],