Todo Checklist

You can run a multi-list task manager as an MCP server to create, organize, and track tasks across multiple lists. It supports priorities, due dates, tags, and sharing, with persistent storage to keep your data safe between restarts.

How to use

Connect your MCP client to the Todo Checklist server to manage multiple task lists. You can create lists, add and organize tasks, view list details, and mark tasks as completed. Tasks can have priorities, due dates, and tags to help you stay organized. You can also share lists with other users, ensuring collaboration remains smooth.

How to install

Prerequisites you need before installing: Node.js 18 or higher and NPM 8 or higher.

Method 1 – Local development installation

Step 1: Clone the repository to your workspace

cd C:\workspace\mcp
git clone (your-repo) mcp-todo-checklist
cd mcp-todo-checklist

Step 2: Install dependencies and build the project

npm install
npm run build

Step 3: Configure the Claude Desktop client to point to the local server

{
  "servers": {
    "todo-checklist": {
      "type": "command",
      "command": "node dist/index.js",
      "cwd": "C:\\workspace\\mcp\\mcp-todo-checklist",
      "config": {
        "storagePath": "./data",
        "commandTimeout": 60000
      }
    }
  }
}

How to install

Method 2 – Global installation for everyday use

Step 1: Install the package globally

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

Step 2: Configure the Claude Desktop client to start the global server

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

Configuration notes

The server stores data in the configured storagePath and can be tuned with a commandTimeout to control how long commands are allowed to run. The local development flow builds the project and runs the compiled index, while the global flow relies on the installed binary to start the server.

Project structure and data model

The server is organized to separate entry, commands, business logic, storage, and types. Core concepts include a Checklist (list) and ChecklistItem (task) with fields for title, description, completion status, due date, priority, and tags.

Development scripts

# Compile the project
npm run build

# Run in development mode
npm run dev

# Watch for changes and recompile
npm run watch

# Start the compiled server
npm start

Configuration references

Configure the storage path and command timeout in the client configuration under the servers.todo-checklist section.

Notes on usage

Only use the commands and configurations shown in your setup. If you run the server locally, point the client to the local node process. If you install globally, ensure the client uses the global command you configured.

Security and maintenance

Keep Node.js and NPM up to date to receive security fixes and performance improvements. Regularly back up your storagePath data to prevent data loss.

Available tools

createList

Create a new task list with an optional description.

addTask

Add a new task to a specified list with title, priority, due date and tags.

listLists

List all task lists with basic metadata.

showList

Show detailed information for a specific list, including tasks.

completeTask

Mark a task within a list as completed.