MCP Server TODO Checklist

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)

Clone the repository

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

Install dependencies and compile

npm install
npm run build

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)

Install the package globally

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

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.

Deploy Server

HTTP connection URL

security – no known vulnerabilities

license - not found

quality - confirmed to work

How are these scores calculated?

local-only server

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

Tools

A server that implements a checklist management system with features like task creation, progress tracking, data persistence, and item comments.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Orchestrator Server
mokafari
A
security
A
license
A
quality
A server for task orchestration and coordination, facilitating task management with dependencies, multi-instance collaboration, and persistent task tracking.
Last updated -
7
23
MIT License
Coding Todo Server
dennismartis
-
security
F
license
-
quality
An MCP server that provides tools and resources for managing a coding project's todo list, allowing users to view, add, update, and delete todo items with details like priority, status, and tags.
Last updated -
1
TaskFlow MCP
pinkpixel-dev
A
security
A
license
A
quality
A task management server that helps AI assistants break down user requests into manageable tasks and track their completion with user approval steps.
Last updated -
17
269
22
MIT License
TODO MCP Server
oseni99
-
security
F
license
-
quality
A minimal Model Context Protocol server implementation that provides tools for managing a to-do list, allowing users to create tasks, list them, and mark them as completed via JSON-RPC calls.
Last updated -

View all related MCP servers

MCP TODO Checklist Server