todoist-mcp

Instructions

Implementation Reference

• src/utils/handlers.ts:311-332 (handler)

  Core execution logic for the 'create_sections' tool (create mode): POSTs each item to Todoist API at '/sections' with parameters name, project_id, and optional order, returning the created item.

  // Create mode
  else {
      finalPath = options.path || options.basePath || '';
  
      let result;
      switch (options.method) {
          case 'GET':
              result = await todoistApi.get(finalPath, apiParams);
              break;
          case 'POST':
              result = await todoistApi.post(finalPath, apiParams);
              break;
          case 'DELETE':
              result = await todoistApi.delete(finalPath);
              break;
      }
  
      return {
          success: true,
          created_item: result,
      };
  }

• src/tools/sections.ts:14-25 (registration)

  Registers the 'create_sections' MCP tool using createBatchApiHandler, specifying the schema, HTTP method, path, and create mode for batch section creation in Todoist.

  createBatchApiHandler({
      name: 'create_sections',
      description: 'Create new sections in Todoist',
      itemSchema: {
          name: z.string(),
          project_id: z.string(),
          order: z.number().int().optional(),
      },
      method: 'POST',
      path: '/sections',
      mode: 'create',
  });

• src/tools/sections.ts:17-21 (schema)

  Zod schema definition for individual section creation input: requires name and project_id, optional order.

  itemSchema: {
      name: z.string(),
      project_id: z.string(),
      order: z.number().int().optional(),
  },