MCP TODO Checklist Server

by hevener10

3 stars
6 downloads
Not rated
GitHub

About

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

Details

Author
hevener10
Repository
hevener10/mcp-todo-checklist
GitHub stars
3
Downloads
6
Categories
Project Management, Productivity

Setting up with Highlight

Follow these steps to add this server as a custom Highlight plugin:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name MCP TODO Checklist Server
    Command (node, npx, python, etc.) node
    Arguments
    • Argument 1 dist/index.js

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

No arquivo claude_desktop_config.json, você pode configurar:

- storagePath: Diretório onde os dados serão armazenados
- commandTimeout: Tempo máximo de execução dos comandos em milissegundos (padrão: 60000)

todo_create

Create a new task list. Parameters: title (string), description (optional string)

todo_add

Add a task to a specified list. Parameters: listTitle (string), taskTitle (string), priority (string), dueDate (string), tags (array of strings)

todo_list

List all task lists.

todo_show

View details of a specific task list. Parameters: listTitle (string)

todo_complete

Mark a task as completed. Parameters: listTitle (string), taskTitle (string)

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp todo checklist server": {
            "cwd": "C:\\workspace\\mcp\\mcp-mr-checklist",
            "env": {},
            "args": [
                "dist/index.js"
            ],
            "command": "node"
        }
    }
}

Linux

{
    "cwd": "C:\\workspace\\mcp\\mcp-mr-checklist",
    "env": [],
    "args": [
        "dist/index.js"
    ],
    "command": "node"
}

Macos

{
    "cwd": "C:\\workspace\\mcp\\mcp-mr-checklist",
    "env": [],
    "args": [
        "dist/index.js"
    ],
    "command": "node"
}

Windows

{
    "cwd": "C:\\workspace\\mcp\\mcp-mr-checklist",
    "env": [],
    "args": [
        "dist/index.js"
    ],
    "command": "node"
}

MCP TODO Checklist

Um servidor MCP que implementa um sistema de checklist para gerenciamento de tarefas no Claude Desktop. O sistema permite criar e gerenciar múltiplas listas de tarefas, com suporte a prioridades, datas de vencimento e tags.

Funcionalidades

- ✅ Criação e gerenciamento de múltiplas listas de tarefas
- 📌 Suporte a prioridades (baixa, média, alta)
- 📅 Datas de vencimento para tarefas
- 🏷️ Sistema de tags para organização
- 👥 Compartilhamento de listas entre usuários
- 💾 Armazenamento persistente em sistema de arquivos

Requisitos

- Node.js 18 ou superior
- NPM 8 ou superior

Instalação

Método 1: Instalação Local (Desenvolvimento)

1. Clone o repositório

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

2. Instale as dependências e compile

npm install
npm run build

3. Configure no 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: Instalação Global (Uso)

1. Instale o pacote globalmente

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

2. Configure no 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 Disponíveis no Claude

Criar uma nova lista

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

Adicionar uma tarefa

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

Listar todas as listas

/todo_list

Ver detalhes de uma lista

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

Marcar tarefa como concluída

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

Estrutura do Projeto

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

Estrutura de Dados

Lista (Checklist)

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

Tarefa (ChecklistItem)

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

Scripts de Desenvolvimento

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.