clear_completed
Remove completed tasks from your todo list to maintain focus on pending items and declutter your markdown file.
Instructions
Remove all completed todo items
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "clear_completed"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/index.ts:182-192 (handler)MCP tool handler for 'clear_completed': calls todoManager.clearCompleted() and returns formatted response with count of cleared todos.
case 'clear_completed': { const count = await this.todoManager.clearCompleted(); return { content: [ { type: 'text', text: `Cleared ${count} completed todo(s)`, }, ], }; } - src/todoManager.ts:226-249 (helper)Core implementation: filters out completed todos, rewrites the markdown file with remaining todos, handles file write errors, returns count of cleared items.
async clearCompleted(): Promise<number> { const todos = (await this.listTodos()).todos; const completedCount = todos.filter((todo) => todo.completed).length; const remainingTodos = todos.filter((todo) => !todo.completed); const markdown = this.formatTodoMarkdown(remainingTodos); try { await writeFile(this.todoFilePath, markdown, 'utf-8'); } catch (error) { if (error instanceof Error && error.message.includes('EACCES')) { throw new Error( `Permission denied: Cannot write to ${this.todoFilePath}. Check file permissions or set TODO_FILE_PATH environment variable to a writable location.` ); } else if (error instanceof Error && error.message.includes('EROFS')) { throw new Error( `Read-only file system: Cannot write to ${this.todoFilePath}. Set TODO_FILE_PATH environment variable to a writable location.` ); } throw error; } return completedCount; } - src/index.ts:102-110 (registration)Registers the 'clear_completed' tool in the ListTools response, including name, description, and empty input schema (no parameters required).
{ name: 'clear_completed', description: 'Remove all completed todo items', inputSchema: { type: 'object', properties: {}, additionalProperties: false, }, }, - src/index.ts:105-109 (schema)Defines the input schema for 'clear_completed' tool: empty object, no required properties.
inputSchema: { type: 'object', properties: {}, additionalProperties: false, },