MCP Todo Checklist Server

🚀 MCP TODO Checklist Check Server

An MCP (Model Context Protocol) server implementing a task list management system for task management in Claude Desktop. This system supports creating and managing multiple task lists, with features such as priority, deadline, and tags.

🚀 Quick Start

The MCP TODO Checklist Check Server is a powerful tool for task management in Claude Desktop. It allows users to create, manage, and share task lists efficiently.

✨ Features

• ✅ Create and manage multiple task lists
• 📌 Support for priorities (low, medium, high)
• 📅 Task deadline setting
• 🏷️ Tag system for categorization
• 👥 Share task lists between users
• 💾 Persistent data storage in the file system

📦 Installation

Requirements

• Node.js 18 or higher
• NPM 8 or higher

Method 1: Local Installation (for Development)

1. Clone the repository

cd C:\workspace\mcp
git clone (your-repository) mcp-mr-checklist
cd mcp-mr-checklist

2. Install dependencies and build

npm install
npm run build

3. Configure 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 (for Usage)

1. Install the package globally

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

2. Configure claude_desktop_config.json:

{
  "servers": {
    "todo-checklist": {
      "type": "command",
      "command": "mcp-server-todo-checklist",
      "config": {
        "storagePath": "C:\\Users\\YOUR_USER\\AppData\\Local\\claude-todo-checklist",
        "commandTimeout": 60000
      }
    }
  }
}

💻 Usage Examples

Available Commands

• /todo_create: Create a new task list
• /todo_read: Read all task lists
• /todo_update: Update an existing task list
• /todo_delete: Delete a specified task list

Example

/todo_create {
  "name": "Work Tasks",
  "tasks": [
    { "title": "Project Report", "priority": "high", "deadline": "2023-10-31" },
    { "title": "Team Meeting", "priority": "medium", "deadline": "2023-11-01" }
  ]
}

📚 Documentation

Project Structure

.
├── src/
│   ├── index.ts                 # Entry file
│   └── checklist.ts            # Checklist management logic
├── schemas/                   # Data validation schemas
│   └── checklist.schema.ts     # Checklist data schema
└── dist/
    └── index.js               # Build output

Configuration Options

In claude_desktop_config.json, you can configure:

• storagePath: The directory path for data storage
• commandTimeout: The maximum timeout for command execution (default unit is milliseconds, 60000)

🔧 Technical Details

• TypeScript
• Model Context Protocol SDK
• Zod (data validation)
• File-based storage system

📄 License

This project is distributed under the MIT License. For more details, please refer to the LICENSE file.