MCP TODO Checklist Server

local-only server

The server can only run on the client’s local machine because it depends on local resources.

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)

  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.

ID: z3gwefnnwr