MCP TODO Checklist

An MCP server deploying a checklist system for task management on Claude Desktop. The system allows you to create and manage multiple task lists, with support for priorities, due dates and tags.

Features

✅ Creating and managing multiple to-do lists
📌 Priority support (low, medium, high)
📅 Due dates for tasks
🏷️ Tag system for organization
👥 Sharing lists between users
💾 Persistent file system storage

Related MCP server: Coding Todo Server

Requirements

Node.js 18 or higher
NPM 8 or higher

Installation

Method 1: Local Installation (Development)

Clone the repository

cd C:\workspace\mcp git clone (seu-repositório) mcp-mr-checklist cd mcp-mr-checklist

Install dependencies and compile

npm install npm run build

Configure in claude_desktop_config.json :

{ "servers": { "todo-checklist": { "type": "command", "command": "node dist/index.js", "cwd": "C:\\workspace\\mcp\\mcp-mr-checklist", "config": { "storagePath": "./data", "commandTimeout": 60000 } } } }

Method 2: Global Installation (Use)

Install the package globally

npm install -g @hevener/server-todo-checklist

Configure in claude_desktop_config.json :

{ "servers": { "todo-checklist": { "type": "command", "command": "mcp-server-todo-checklist", "config": { "storagePath": "C:\\Users\\SEU_USUARIO\\AppData\\Local\\claude-todo-checklist", "commandTimeout": 60000 } } } }

Commands Available in Claude

Create a new list

/todo_create { "title": "Minha Lista", "description": "Descrição opcional da lista" }

Add a task

/todo_add { "listTitle": "Minha Lista", "taskTitle": "Nova Tarefa", "priority": "high", "dueDate": "2024-01-20", "tags": ["trabalho", "urgente"] }

List all lists

/todo_list

View details of a list

/todo_show { "listTitle": "Minha Lista" }

Mark task as complete

/todo_complete { "listTitle": "Minha Lista", "taskTitle": "Nova Tarefa" }

Project Structure

src/ ├── index.ts # Ponto de entrada do servidor ├── commands.ts # Definição dos comandos disponíveis ├── service/ │ └── ChecklistService.ts # Lógica de negócio ├── storage/ │ └── index.ts # Implementação do armazenamento └── types/ ├── ChecklistItem.ts # Tipos para itens └── index.ts # Tipos principais

Data Structure

Checklist

interface Checklist { id: string; title: string; description?: string; items: ChecklistItem[]; owner: string; shared?: string[]; createdAt: Date; updatedAt: Date; }

Task (ChecklistItem)

interface ChecklistItem { id: string; title: string; description?: string; completed: boolean; dueDate?: Date; priority: 'low' | 'medium' | 'high'; tags: string[]; createdAt: Date; updatedAt: Date; }

Development Scripts

# Compilar o projeto npm run build # Executar em modo desenvolvimento npm run dev # Observar alterações e recompilar npm run watch # Iniciar o servidor compilado npm start

Settings

In the claude_desktop_config.json file, you can configure:

storagePath : Directory where data will be stored
commandTimeout : Maximum command execution time in milliseconds (default: 60000)

Technologies Used

TypeScript
Model Context Protocol SDK
Zod (data validation)
File-based storage system

License

Distributed under the MIT License. See LICENSE for more information.

MCP TODO Checklist Server