Skip to main content
Glama
MCP TODO Checklist Server

MCP TODO Checklist Server

by hevener10

Lista de verificación TODO de MCP

Un servidor MCP que implementa un sistema de lista de verificación para la gestión de tareas en Claude Desktop. El sistema permite crear y administrar múltiples listas de tareas, con soporte para prioridades, fechas de vencimiento y etiquetas.

Características

  • ✅ Crear y gestionar múltiples listas de tareas pendientes

  • 📌 Soporte prioritario (bajo, medio, alto)

  • 📅 Fechas de vencimiento de las tareas

  • 🏷️ Sistema de etiquetas para organización

  • 👥 Compartir listas entre usuarios

  • Almacenamiento persistente del sistema de archivos

Related MCP server: Todo MCP Server

Requisitos

  • Node.js 18 o superior

  • NPM 8 o superior

Instalación

Método 1: Instalación local (desarrollo)

  1. Clonar el repositorio

cd C:\workspace\mcp
git clone (seu-repositório) mcp-mr-checklist
cd mcp-mr-checklist
  1. Instalar dependencias y compilar

npm install
npm run build
  1. Configurar en 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: Instalación global (Uso)

  1. Instalar el paquete globalmente

npm install -g @hevener/server-todo-checklist
  1. Configurar en 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 disponibles en Claude

Crear una nueva lista

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

Agregar una tarea

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

Listar todas las listas

/todo_list

Ver detalles de una lista

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

Marcar la tarea como completada

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

Estructura del proyecto

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

Estructura de datos

Lista de verificación

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

Tarea (Elemento de lista de verificación)

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

Scripts de desarrollo

# 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

Ajustes

En el archivo claude_desktop_config.json , puedes configurar:

  • storagePath : Directorio donde se almacenarán los datos

  • commandTimeout : Tiempo máximo de ejecución del comando en milisegundos (predeterminado: 60000)

Tecnologías utilizadas

  • Mecanografiado

  • SDK de protocolo de contexto de modelo

  • Zod (validación de datos)

  • Sistema de almacenamiento basado en archivos

Licencia

Distribuido bajo la licencia MIT. Consulte LICENSE para obtener más información.

Available Tools

5 tools
todo_addC

Adiciona uma nova tarefa à lista

Inputs: listTitle (required), taskTitle (required), priority, dueDate, +1 more.

todo_completeC

Marca uma tarefa como concluída

Inputs: listTitle (required), taskTitle (required).

todo_createC

Cria uma nova lista de tarefas

Inputs: title (required), description.

todo_listC

Lista todas as listas de tarefas

Inputs: no named parameters.

todo_showC

Mostra os detalhes de uma lista específica

Inputs: listTitle (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 5 tools

    Disambiguation3/5

    The tools have clear purposes but some overlap exists, particularly between 'todo_add' (add a task to a list) and 'todo_create' (create a new task list), which could cause confusion if an agent needs to distinguish between adding tasks and creating lists. Descriptions help clarify, but the boundary is not perfectly distinct.

    Naming Consistency5/5

    All tool names follow a consistent 'todo_' prefix with a descriptive verb (add, complete, create, list, show), using snake_case uniformly. This predictable pattern makes it easy for agents to understand and navigate the toolset.

    Tool Count5/5

    With 5 tools, this server is well-scoped for a TODO checklist domain, covering core operations like creating lists, adding tasks, marking completion, and viewing details. Each tool earns its place without feeling excessive or insufficient.

    Completeness3/5

    The toolset covers basic CRUD operations but has notable gaps, such as missing update and delete functions for tasks or lists (e.g., no 'todo_update' or 'todo_delete'). Agents can work around this by using existing tools, but it limits full lifecycle management.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      Not graded
      maintenance
      Enhanced TickTick task management server that provides rich functionality including task assignment, section management, comments, and batch operations with significantly improved performance through checkpoint sync.
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server for managing todo lists and items with advanced features including task assignment, priorities, recurrence, filtering, and webhook notifications.
      1
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for task/ticket management with dependency tracking, supporting CRUD operations, status management, project filtering, and automatic data migrations.
      1
      AGPL 3.0