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
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
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 storedcommandTimeout
: 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.