Todo Markdown MCP Server

Instructions

Implementation Reference

• src/todoManager.ts:198-224 (handler)

  The core handler function that deletes a todo item by ID from the todo markdown file. It parses the file, removes the matching todo, and writes back the updated markdown.

  async deleteTodo(request: DeleteTodoRequest): Promise<void> {
    const todos = (await this.listTodos()).todos;
    const todoIndex = todos.findIndex((todo) => todo.id === request.id);
  
    if (todoIndex === -1) {
      throw new Error(`Todo with id ${request.id} not found`);
    }
  
    todos.splice(todoIndex, 1);
  
    const markdown = this.formatTodoMarkdown(todos);
  
    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;
    }
  }

• src/index.ts:164-180 (handler)

  The MCP CallToolRequest handler case for 'delete_todo', which validates the input arguments and delegates to the todoManager.deleteTodo method, returning a success message.

  case 'delete_todo': {
    const args = request.params
      .arguments as unknown as DeleteTodoRequest;
    if (!args?.id || typeof args.id !== 'string') {
      throw new Error('ID is required and must be a string');
    }
  
    await this.todoManager.deleteTodo(args);
    return {
      content: [
        {
          type: 'text',
          text: `Todo with ID ${args.id} deleted successfully`,
        },
      ],
    };
  }

• src/index.ts:87-101 (registration)

  Tool registration in the ListToolsRequestHandler response, defining the name, description, and input schema for the 'delete_todo' tool.

  {
    name: 'delete_todo',
    description: 'Delete a todo item',
    inputSchema: {
      type: 'object',
      properties: {
        id: {
          type: 'string',
          description: 'The todo item ID to delete',
        },
      },
      required: ['id'],
      additionalProperties: false,
    },
  },

• src/types.ts:24-26 (schema)

  TypeScript type definition for the DeleteTodoRequest used by the delete_todo handlers.

  export interface DeleteTodoRequest {
    id: string;
  }