What is Mcp Todo Checklist

mcp-todo-checklist is an MCP server that implements a checklist system for task management within Claude Desktop. It allows users to create and manage multiple task lists with support for priorities, due dates, and tags.

Use cases

Use cases for mcp-todo-checklist include managing personal to-do lists, coordinating team tasks in a project, tracking deadlines for assignments, and organizing work-related tasks with tags for better categorization.

How to use

To use mcp-todo-checklist, you can either install it locally for development or globally for general use. After installation, configure the server in the ‘claude_desktop_config.json’ file and utilize available commands to create lists and add tasks.

Key features

Key features include the ability to create and manage multiple task lists, support for priority levels (low, medium, high), due dates for tasks, a tagging system for organization, user list sharing, and persistent storage in the file system.

Where to use

mcp-todo-checklist can be used in various fields that require task management, such as project management, personal productivity, team collaboration, and any scenario where organizing tasks is essential.

MCP TODO Checklist

Um servidor MCP que implementa um sistema de checklist para gerenciamento de tarefas no Claude Desktop. O sistema permite criar e gerenciar múltiplas listas de tarefas, com suporte a prioridades, datas de vencimento e tags.

Funcionalidades

• ✅ Criação e gerenciamento de múltiplas listas de tarefas
• 📌 Suporte a prioridades (baixa, média, alta)
• 📅 Datas de vencimento para tarefas
• 🏷️ Sistema de tags para organização
• 👥 Compartilhamento de listas entre usuários
• 💾 Armazenamento persistente em sistema de arquivos

Requisitos

• Node.js 18 ou superior
• NPM 8 ou superior

Instalação

Método 1: Instalação Local (Desenvolvimento)

1. Clone o repositório

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

2. Instale as dependências e compile

npm install
npm run build

3. Configure no 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
      }
    }
  }
}

Método 2: Instalação Global (Uso)

1. Instale o pacote globalmente

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

2. Configure no 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
      }
    }
  }
}

Comandos Disponíveis no Claude

Criar uma nova lista

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

Adicionar uma tarefa

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

Listar todas as listas

/todo_list

Ver detalhes de uma lista

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

Marcar tarefa como concluída

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

Estrutura do Projeto

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

Estrutura de Dados

Lista (Checklist)

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

Tarefa (ChecklistItem)

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

Scripts de Desenvolvimento

# 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

Configurações

No arquivo claude_desktop_config.json, você pode configurar:

• storagePath: Diretório onde os dados serão armazenados
• commandTimeout: Tempo máximo de execução dos comandos em milissegundos (padrão: 60000)

Tecnologias Utilizadas

• TypeScript
• Model Context Protocol SDK
• Zod (validação de dados)
• Sistema de armazenamento baseado em arquivos

Licença

Distribuído sob a licença MIT. Veja LICENSE para mais informações.