LABSCO SUMMARY

The task list stays as one file on your own machine.

There is no service behind this — better-sqlite3 and a path you choose — so it is easy to back up, open in any SQLite client, or throw away. The resources matter as much as the tools: overdue and pending are things the assistant can pull into context before you ask a question.

What it is

A small task manager over MCP, written in TypeScript and backed by a local SQLite file. It exposes todos as callable tools, as read-only resources the assistant can pull without being asked, and as a few canned review workflows.

What you get

Create, update, complete, delete, list and search todos, plus a stats tool
Read-only resources for all, completed, pending and overdue todos, a single todo by id, and todos filtered by priority or tag — a couple of them support autocomplete
Canned prompts for daily review, weekly planning, productivity analysis and task breakdown
Each todo carries a title, description, completed flag, priority, due date and tags, with timestamps

Requirements

Node.js, with the repo cloned and built (npm install, npm run build), then run over stdio as node dist/index.js. No account and no key. TODO_DB_PATH points at the SQLite file and defaults to todos.db in the working directory.

Setup effort

Build from source

See installation options

USE CASES

01

Capturing a task mid-conversation

Say it while you are working on something else and it lands in the list with a priority and a due date.

02

A morning review without opening an app

The daily-review prompt walks what is pending and what has gone overdue.

03

Finding a task you only half remember

Search across titles and descriptions, or narrow by priority or tag.

04

Keeping the data portable

Everything is rows in the SQLite file at TODO_DB_PATH, readable by any SQLite client.

BEFORE YOU INSTALL

What to know first

Optional

TODO_DB_PATH in your environment

Where it runs

The documented client runs the server on your machine.

INSTALLATION

Connect your client

You clone and build this one yourself.

Server setup

TERMINAL

git clone https://github.com/Xczer/todo-mcp-server
cd todo-mcp-server
npm install
npm run build

MCP Clients

Claude Desktop

CLAUDE DESKTOP · JSON

{
  "mcpServers": {
    "todo-manager": {
      "command": "node",
      "args": [
        "<YOUR_PATH_TO_TODO_MCP_SERVER>/dist/index.js"
      ],
      "env": {
        "TODO_DB_PATH": "<YOUR_TODO_DB_PATH>"
      }
    }
  }
}

Todo MCP Server