Skip to main content
Glama
MCP TODO Checklist Server

MCP TODO Checklist Server

by hevener10

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: Todo MCP Server

Requirements

  • Node.js 18 or higher

  • NPM 8 or higher

Installation

Method 1: Local Installation (Development)

  1. Clone the repository

cd C:\workspace\mcp
git clone (seu-repositório) mcp-mr-checklist
cd mcp-mr-checklist
  1. Install dependencies and compile

npm install
npm run build
  1. 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)

  1. Install the package globally

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

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