MCP TODO Checklist Server
The MCP TODO Checklist Server is a task management system that allows you to create and manage multiple task lists. With this server, you can:
Create new task lists with titles and optional descriptions
Add tasks with priority levels (low, medium, high), due dates, and tags
List all available checklists
View detailed information about specific lists
Mark tasks as completed
Share lists with other users
Organize and categorize tasks using tags
Store all data persistently on the file system
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP TODO Checklist Server add 'Buy groceries' to my shopping list with high priority"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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)
Clone the repository
cd C:\workspace\mcp
git clone (seu-repositório) mcp-mr-checklist
cd mcp-mr-checklistInstall dependencies and compile
npm install
npm run buildConfigure 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-checklistConfigure 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_listView 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 principaisData 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 startSettings
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.
Available Tools
5 toolstodo_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
Scored across 5 tools
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.
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.
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.
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
Related MCP Connectors
Zoom Tasks server for creating, updating, assigning, and synchronizing task workflows.
ADHD-friendly task management MCP server for ChaTodo: organize tasks, lists, and priorities.
Official Todoist MCP server. Manage tasks and projects. Hosted, no API key needed.
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceEnhanced TickTick task management server that provides rich functionality including task assignment, section management, comments, and batch operations with significantly improved performance through checkpoint sync.-
- FlicenseNot gradedqualityDmaintenanceA Model Context Protocol server for managing todo lists and items with advanced features including task assignment, priorities, recurrence, filtering, and webhook notifications.1-
- AlicenseNot gradedqualityDmaintenanceMCP server for task/ticket management with dependency tracking, supporting CRUD operations, status management, project filtering, and automatic data migrations.1AGPL 3.0
- AlicenseNot gradedqualityDmaintenanceA CRUD todo list server that exposes tools to create, list, and conclude tasks, compatible with any MCP host.6 npmMIT