@j0hanz/todokit-mcp 1.0.1

package/dist/tools/delete_todo.js

@@ -0,0 +1,95 @@
+import { createErrorResponse, getErrorMessage } from '../lib/errors.js';
+import { resolveTodoTargetFromTodos, toResolveInput, unwrapResolution, } from '../lib/resolve.js';
+import { deleteTodoBySelector, getTodos } from '../lib/storage.js';
+import { createToolResponse } from '../lib/tool_response.js';
+import { DeleteTodoSchema } from '../schemas/inputs.js';
+import { DefaultOutputSchema } from '../schemas/outputs.js';
+function buildDryRunSingle(todo) {
+    return createToolResponse({
+        ok: true,
+        result: {
+            deletedIds: [todo.id],
+            summary: `Dry run: would delete todo "${todo.title}"`,
+            dryRun: true,
+        },
+    });
+}
+function buildDryRunMultiple(previews, total) {
+    return createToolResponse({
+        ok: true,
+        result: {
+            deletedIds: [],
+            summary: `Dry run: ${String(total)} todos would be deleted`,
+            matches: previews,
+            totalMatches: total,
+            dryRun: true,
+        },
+    });
+}
+function buildDeleteSuccess(todo) {
+    return createToolResponse({
+        ok: true,
+        result: {
+            deletedIds: [todo.id],
+            summary: `Deleted todo "${todo.title}"`,
+            nextActions: ['list_todos'],
+        },
+    });
+}
+function handleAmbiguousDelete(outcome, dryRun) {
+    if (dryRun) {
+        return buildDryRunMultiple(outcome.previews, outcome.matches.length);
+    }
+    return outcome.response;
+}
+function handleMatchDelete(todo, dryRun) {
+    if (dryRun) {
+        return buildDryRunSingle(todo);
+    }
+    return buildDeleteSuccess(todo);
+}
+async function handleDeleteTodoDryRun(input) {
+    const todos = await getTodos();
+    const outcome = unwrapResolution(resolveTodoTargetFromTodos(todos, toResolveInput({ id: input.id, query: input.query })));
+    if (outcome.kind === 'error')
+        return outcome.response;
+    if (outcome.kind === 'ambiguous') {
+        return handleAmbiguousDelete(outcome, true);
+    }
+    return handleMatchDelete(outcome.todo, true);
+}
+async function handleDeleteTodoLive(input) {
+    const outcome = await deleteTodoBySelector(toResolveInput({ id: input.id, query: input.query }));
+    if (outcome.kind === 'error' || outcome.kind === 'ambiguous') {
+        return outcome.response;
+    }
+    return handleMatchDelete(outcome.todo, false);
+}
+async function handleDeleteTodo(input) {
+    const dryRun = input.dryRun ?? false;
+    if (dryRun) {
+        return handleDeleteTodoDryRun(input);
+    }
+    return handleDeleteTodoLive(input);
+}
+export function registerDeleteTodo(server) {
+    server.registerTool('delete_todo', {
+        title: 'Delete Todo',
+        description: 'Delete a todo item (supports dry-run)',
+        inputSchema: DeleteTodoSchema,
+        outputSchema: DefaultOutputSchema,
+        annotations: {
+            readOnlyHint: false,
+            idempotentHint: true,
+            destructiveHint: true,
+        },
+    }, async (input) => {
+        try {
+            return await handleDeleteTodo(input);
+        }
+        catch (err) {
+            return createErrorResponse('E_DELETE_TODO', getErrorMessage(err));
+        }
+    });
+}
+//# sourceMappingURL=delete_todo.js.map

package/dist/tools/delete_todo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete_todo.js","sourceRoot":"","sources":["../../src/tools/delete_todo.ts"],"names":[],"mappings":"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"}

package/dist/tools/index.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerAllTools(server: McpServer): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASzE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAOxD"}

package/dist/tools/index.js

@@ -0,0 +1,15 @@
+import { registerAddTodo } from './add_todo.js';
+import { registerAddTodos } from './add_todos.js';
+import { registerCompleteTodo } from './complete_todo.js';
+import { registerDeleteTodo } from './delete_todo.js';
+import { registerListTodos } from './list_todos.js';
+import { registerUpdateTodo } from './update_todo.js';
+export function registerAllTools(server) {
+    registerAddTodo(server);
+    registerAddTodos(server);
+    registerListTodos(server);
+    registerUpdateTodo(server);
+    registerCompleteTodo(server);
+    registerDeleteTodo(server);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,MAAM,UAAU,gBAAgB,CAAC,MAAiB;IAChD,eAAe,CAAC,MAAM,CAAC,CAAC;IACxB,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzB,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAC7B,CAAC"}

package/dist/tools/list_todos.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerListTodos(server: McpServer): void;
+//# sourceMappingURL=list_todos.d.ts.map

package/dist/tools/list_todos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_todos.d.ts","sourceRoot":"","sources":["../../src/tools/list_todos.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA4MzE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAqBzD"}

package/dist/tools/list_todos.js

@@ -0,0 +1,157 @@
+import { createErrorResponse, getErrorMessage } from '../lib/errors.js';
+import { getTodos } from '../lib/storage.js';
+import { createToolResponse } from '../lib/tool_response.js';
+import { ListTodosFilterSchema } from '../schemas/inputs.js';
+import { DefaultOutputSchema } from '../schemas/outputs.js';
+const DEFAULT_LIMIT = 50;
+const DEFAULT_OFFSET = 0;
+const PRIORITY_WEIGHT = {
+    low: 1,
+    normal: 2,
+    high: 3,
+};
+const MISSING_DUE_DATE = '9999-12-31';
+function getTodayIso() {
+    return new Date().toISOString().slice(0, 10);
+}
+function isOverdue(todo, todayIso) {
+    if (!todo.dueDate)
+        return false;
+    if (todo.completed)
+        return false;
+    return todo.dueDate < todayIso;
+}
+function compareStrings(a, b) {
+    return a.localeCompare(b);
+}
+function getDueDateKey(todo) {
+    return todo.dueDate ?? MISSING_DUE_DATE;
+}
+function compareDueDate(a, b) {
+    return compareStrings(getDueDateKey(a), getDueDateKey(b));
+}
+function comparePriority(a, b) {
+    return PRIORITY_WEIGHT[a.priority] - PRIORITY_WEIGHT[b.priority];
+}
+function compareTitle(a, b) {
+    return compareStrings(a.title, b.title);
+}
+function compareCreatedAt(a, b) {
+    return compareStrings(a.createdAt, b.createdAt);
+}
+const COMPARATORS = {
+    dueDate: compareDueDate,
+    priority: comparePriority,
+    title: compareTitle,
+    createdAt: compareCreatedAt,
+};
+function sortTodos(todos, sortBy, order) {
+    const direction = order === 'desc' ? -1 : 1;
+    const comparator = COMPARATORS[sortBy];
+    return [...todos].sort((a, b) => {
+        const primary = comparator(a, b) * direction;
+        if (primary !== 0)
+            return primary;
+        return compareCreatedAt(a, b);
+    });
+}
+function normalizeQuery(query) {
+    const trimmed = query?.trim();
+    return trimmed && trimmed.length > 0 ? trimmed : undefined;
+}
+function resolveCompletedFilter(status, completed) {
+    if (status === 'pending')
+        return false;
+    if (status === 'completed')
+        return true;
+    return completed;
+}
+function normalizeFilters(filters) {
+    return {
+        completed: resolveCompletedFilter(filters.status, filters.completed),
+        priority: filters.priority,
+        tag: filters.tag,
+        dueBefore: filters.dueBefore,
+        dueAfter: filters.dueAfter,
+        query: normalizeQuery(filters.query),
+        sortBy: filters.sortBy ?? 'createdAt',
+        order: filters.order ?? 'asc',
+        limit: filters.limit ?? DEFAULT_LIMIT,
+        offset: filters.offset ?? DEFAULT_OFFSET,
+    };
+}
+function countMatches(todos, predicate) {
+    return todos.reduce((total, todo) => total + (predicate(todo) ? 1 : 0), 0);
+}
+function computeCounts(todos, todayIso) {
+    const total = todos.length;
+    const completed = countMatches(todos, (todo) => todo.completed);
+    const overdue = countMatches(todos, (todo) => isOverdue(todo, todayIso));
+    return {
+        total,
+        completed,
+        pending: total - completed,
+        overdue,
+    };
+}
+function buildSummary(counts, pageCount) {
+    if (counts.total === 0) {
+        return 'No todos found';
+    }
+    const overdueSuffix = counts.overdue > 0 ? `, ${String(counts.overdue)} overdue` : '';
+    return `Showing ${String(pageCount)} of ${String(counts.total)} todos (${String(counts.pending)} pending, ${String(counts.completed)} completed${overdueSuffix}).`;
+}
+function paginateTodos(todos, offset, limit) {
+    return todos.slice(offset, offset + limit);
+}
+async function handleListTodos(filters) {
+    const normalized = normalizeFilters(filters);
+    const allTodos = await getTodos({
+        completed: normalized.completed,
+        priority: normalized.priority,
+        tag: normalized.tag,
+        dueBefore: normalized.dueBefore,
+        dueAfter: normalized.dueAfter,
+        query: normalized.query,
+    });
+    const todayIso = getTodayIso();
+    const counts = computeCounts(allTodos, todayIso);
+    const sorted = sortTodos(allTodos, normalized.sortBy, normalized.order);
+    const paged = paginateTodos(sorted, normalized.offset, normalized.limit);
+    const summary = buildSummary(counts, paged.length);
+    return createToolResponse({
+        ok: true,
+        result: {
+            items: paged,
+            summary,
+            counts: {
+                total: counts.total,
+                pending: counts.pending,
+                completed: counts.completed,
+                overdue: counts.overdue,
+            },
+            limit: normalized.limit,
+            offset: normalized.offset,
+        },
+    });
+}
+export function registerListTodos(server) {
+    server.registerTool('list_todos', {
+        title: 'List Todos',
+        description: 'List todos with filtering, search, sorting, and pagination',
+        inputSchema: ListTodosFilterSchema,
+        outputSchema: DefaultOutputSchema,
+        annotations: {
+            readOnlyHint: true,
+            idempotentHint: true,
+        },
+    }, async (filters) => {
+        try {
+            return await handleListTodos(filters);
+        }
+        catch (err) {
+            return createErrorResponse('E_LIST_TODOS', getErrorMessage(err));
+        }
+    });
+}
+//# sourceMappingURL=list_todos.js.map

package/dist/tools/list_todos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_todos.js","sourceRoot":"","sources":["../../src/tools/list_todos.ts"],"names":[],"mappings":"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"}

package/dist/tools/update_todo.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerUpdateTodo(server: McpServer): void;
+//# sourceMappingURL=update_todo.d.ts.map

package/dist/tools/update_todo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update_todo.d.ts","sourceRoot":"","sources":["../../src/tools/update_todo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAsIzE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAqB1D"}

package/dist/tools/update_todo.js

@@ -0,0 +1,90 @@
+import { createErrorResponse, getErrorMessage } from '../lib/errors.js';
+import { toResolveInput } from '../lib/resolve.js';
+import { normalizeTags, updateTodoBySelector } from '../lib/storage.js';
+import { createToolResponse } from '../lib/tool_response.js';
+import { UpdateTodoSchema } from '../schemas/inputs.js';
+import { DefaultOutputSchema } from '../schemas/outputs.js';
+function applyClearFields(updates, fieldsToClear) {
+    if (fieldsToClear.has('description')) {
+        updates.description = undefined;
+    }
+    if (fieldsToClear.has('dueDate')) {
+        updates.dueDate = undefined;
+    }
+}
+function countTags(tags) {
+    return tags ? tags.length : 0;
+}
+function hasTagOps(tagOps) {
+    return countTags(tagOps?.add) > 0 || countTags(tagOps?.remove) > 0;
+}
+function shouldApplyTagUpdates(updates, fieldsToClear, tagOps) {
+    if (updates.tags !== undefined)
+        return false;
+    return fieldsToClear.has('tags') || hasTagOps(tagOps);
+}
+function resolveBaseTags(baseTodo, fieldsToClear) {
+    if (fieldsToClear.has('tags')) {
+        return [];
+    }
+    return baseTodo.tags;
+}
+function safeTagList(tags) {
+    return tags ?? [];
+}
+function buildMergedTags(baseTodo, fieldsToClear, tagOps) {
+    const baseTags = resolveBaseTags(baseTodo, fieldsToClear);
+    const addTags = normalizeTags(safeTagList(tagOps?.add));
+    const removeTags = new Set(normalizeTags(safeTagList(tagOps?.remove)));
+    return normalizeTags([...baseTags, ...addTags]).filter((tag) => !removeTags.has(tag));
+}
+function applyTagUpdates(updates, baseTodo, fieldsToClear, tagOps) {
+    if (!shouldApplyTagUpdates(updates, fieldsToClear, tagOps))
+        return;
+    updates.tags = buildMergedTags(baseTodo, fieldsToClear, tagOps);
+}
+function buildUpdatePayload(baseTodo, input) {
+    const { clearFields, tagOps, ...updates } = input;
+    const fieldsToClear = new Set(clearFields ?? []);
+    const nextUpdates = { ...updates };
+    applyClearFields(nextUpdates, fieldsToClear);
+    applyTagUpdates(nextUpdates, baseTodo, fieldsToClear, tagOps);
+    return Object.keys(nextUpdates).length > 0 ? nextUpdates : null;
+}
+async function handleUpdateTodo(input) {
+    const outcome = await updateTodoBySelector(toResolveInput({ id: input.id, query: input.query }), (todo) => buildUpdatePayload(todo, input));
+    if (outcome.kind === 'error' || outcome.kind === 'ambiguous') {
+        return outcome.response;
+    }
+    if (outcome.kind === 'no_updates') {
+        return createErrorResponse('E_BAD_REQUEST', 'No fields provided to update');
+    }
+    return createToolResponse({
+        ok: true,
+        result: {
+            item: outcome.todo,
+            summary: `Updated todo "${outcome.todo.title}"`,
+            nextActions: ['list_todos', 'complete_todo'],
+        },
+    });
+}
+export function registerUpdateTodo(server) {
+    server.registerTool('update_todo', {
+        title: 'Update Todo',
+        description: 'Update fields on a todo item (supports search and tag ops)',
+        inputSchema: UpdateTodoSchema,
+        outputSchema: DefaultOutputSchema,
+        annotations: {
+            readOnlyHint: false,
+            idempotentHint: true,
+        },
+    }, async (input) => {
+        try {
+            return await handleUpdateTodo(input);
+        }
+        catch (err) {
+            return createErrorResponse('E_UPDATE_TODO', getErrorMessage(err));
+        }
+    });
+}
+//# sourceMappingURL=update_todo.js.map

package/dist/tools/update_todo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update_todo.js","sourceRoot":"","sources":["../../src/tools/update_todo.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@j0hanz/todokit-mcp",
+  "version": "1.0.1",
+  "mcpName": "io.github.j0hanz/todokit",
+  "description": "A MCP server for Todokit, a task management and productivity tool with JSON storage.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "sideEffects": false,
+  "bin": {
+    "todokit-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "clean": "node -e \"require('fs').rmSync('dist', {recursive: true, force: true})\"",
+    "build": "tsc",
+    "dev": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "test": "node --import tsx/esm --test tests/*.test.ts",
+    "test:coverage": "node --import tsx/esm --test --experimental-test-coverage tests/*.test.ts",
+    "lint": "eslint .",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "type-check": "tsc --noEmit",
+    "bench": "tsx benchmark/bench.ts",
+    "dup-check": "jscpd -c .jscpd.json src",
+    "inspector": "npx @modelcontextprotocol/inspector",
+    "prepublishOnly": "npm run lint && npm run type-check && npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "todo",
+    "task-management",
+    "productivity",
+    "json-storage",
+    "todokit"
+  ],
+  "author": "j0hanz",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/j0hanz/todokit-mcp-server.git"
+  },
+  "homepage": "https://github.com/j0hanz/todokit-mcp-server#readme",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.1",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "@trivago/prettier-plugin-sort-imports": "^6.0.0",
+    "@types/node": "^22.19.3",
+    "eslint": "^9.23.2",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-unused-imports": "^4.3.0",
+    "jscpd": "4.0.5",
+    "prettier": "^3.7.4",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.50.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}