todoist-mcp

Instructions

Implementation Reference

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

  Core logic for updating projects: resolves project ID by name if needed, validates path parameter, constructs /projects/{id} path, removes ID from params, performs POST request to Todoist API, and formats response.
  if (options.mode !== 'create' && options.idField) { let itemId = item[options.idField]; let matchedName = null; let matchedContent = null; // If no ID but name is provided, search by name if (!itemId && item[options.nameField!] && options.findByName) { const searchName = item[options.nameField!]; const matchedItem = options.findByName(searchName, allItems); if (!matchedItem) { return { success: false, error: `Item not found with name: ${searchName}`, item, }; } itemId = matchedItem.id; matchedName = searchName; matchedContent = matchedItem.content; } if (!itemId) { return { success: false, error: `Either ${options.idField} or ${options.nameField} must be provided`, item, }; } // Apply security validation to itemId before using in path const safeItemId = validatePathParameter(itemId, options.idField || 'id'); if (options.basePath && options.pathSuffix) { finalPath = `${options.basePath}${options.pathSuffix.replace('{id}', safeItemId)}`; } else if (options.path) { finalPath = options.path.replace('{id}', safeItemId); } delete apiParams[options.idField]; if (options.nameField) { delete apiParams[options.nameField]; } 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; } const response: any = { success: true, id: itemId, result, }; if (matchedName) { response.found_by_name = matchedName; response.matched_content = matchedContent; } return response; } // Create mode
• src/tools/projects.ts:47-64 (registration)

  Registers the 'update_projects' MCP tool using the batch API handler factory, defining input schema, HTTP method, path, update mode, ID/name fields, and name matching logic.
  createBatchApiHandler({ name: 'update_projects', description: 'Update projects in Todoist', itemSchema: { id: z.string().optional().describe('ID of the project to update (preferred over name)'), name: z.string().optional().describe('Name of the project to update'), color: z.string().optional(), is_favorite: z.boolean().optional(), view_style: z.enum(['list', 'board']).optional(), }, method: 'POST', path: '/projects/{id}', mode: 'update', idField: 'id', nameField: 'name', findByName: (name, items) => items.find(item => item.name.toLowerCase().includes(name.toLowerCase())), });
• src/tools/projects.ts:50-56 (schema)

  Zod schema defining input parameters for updating a project: ID or name (required), optional color, favorite status, and view style.
  itemSchema: { id: z.string().optional().describe('ID of the project to update (preferred over name)'), name: z.string().optional().describe('Name of the project to update'), color: z.string().optional(), is_favorite: z.boolean().optional(), view_style: z.enum(['list', 'board']).optional(), },