@cyb3rk1d/todo-ai-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Gary Kamoto Mhone (cyb3rk1d)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,97 @@
+# @cyb3rk1d/todo-ai-mcp
+
+[![npm version](https://img.shields.io/npm/v/@cyb3rk1d/todo-ai-mcp)](https://www.npmjs.com/package/@cyb3rk1d/todo-ai-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+An [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server that connects Claude Code to [Todo AI](https://cybers-todo.vercel.app). Manage your todo list, view summaries, and get AI recommendations directly from the CLI.
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `list_todos` | List all your todos |
+| `get_todo` | Get a specific todo by ID |
+| `create_todo` | Create a new todo with title, description, category, priority |
+| `update_todo` | Update any field on a todo |
+| `complete_todo` | Mark a todo as completed |
+| `delete_todo` | Delete a todo permanently |
+| `get_todos_by_date` | Get todos for a specific date |
+| `get_todos_by_range` | Get todos within a date range |
+| `get_today_summary` | Get today's daily summary |
+| `list_summaries` | List all daily summaries |
+| `create_summary` | Create a daily achievement summary |
+| `get_current_review` | Get the current week's review |
+| `list_reviews` | List all weekly reviews |
+| `get_recommendations` | Get AI productivity recommendations |
+| `generate_daily_summary` | AI-generate a daily summary from tasks |
+| `generate_weekly_review` | AI-generate a weekly performance review |
+
+## Setup
+
+### 1. Generate an API Token
+
+Log into your Todo AI app and generate a long-lived API token:
+
+```bash
+curl -X POST https://cybers-todo.vercel.app/api/auth/api-token \
+  -H "Authorization: Bearer <your-access-token>" \
+  -H "Content-Type: application/json"
+```
+
+This returns a token valid for 30 days.
+
+### 2. Configure Claude Code
+
+Add the MCP server to your project's `.mcp.json` or `~/.claude/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "todo-ai": {
+      "command": "npx",
+      "args": ["-y", "@cyb3rk1d/todo-ai-mcp"],
+      "env": {
+        "TODO_AI_API_URL": "https://cybers-todo.vercel.app",
+        "TODO_AI_TOKEN": "<your-api-token>"
+      }
+    }
+  }
+}
+```
+
+### 3. Use It
+
+Once configured, Claude Code will have access to all Todo AI tools. You can say things like:
+
+- "Add a todo to fix the login bug with high priority"
+- "Show me my todos for today"
+- "Mark that authentication todo as completed"
+- "What are my AI recommendations?"
+- "Generate a summary of what I did today"
+
+## Development
+
+```bash
+git clone https://github.com/ZedTechInfo/todo-ai.git
+cd todo-ai/mcp-server
+
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Watch mode
+npm run dev
+```
+
+## Environment Variables
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `TODO_AI_TOKEN` | Yes | - | API token from Todo AI |
+| `TODO_AI_API_URL` | No | `http://localhost:4000` | Backend API URL |
+
+## License
+
+[MIT](LICENSE) - Gary Kamoto Mhone (cyb3rk1d)

package/dist/api-client.d.ts

@@ -0,0 +1,13 @@
+/**
+ * HTTP client for the Todo AI backend API.
+ */
+interface ApiResponse<T = unknown> {
+    ok: boolean;
+    status: number;
+    data: T;
+}
+export declare function apiGet<T = unknown>(path: string): Promise<ApiResponse<T>>;
+export declare function apiPost<T = unknown>(path: string, body?: unknown): Promise<ApiResponse<T>>;
+export declare function apiPut<T = unknown>(path: string, body: unknown): Promise<ApiResponse<T>>;
+export declare function apiDelete(path: string): Promise<ApiResponse<null>>;
+export {};

package/dist/api-client.js

@@ -0,0 +1,47 @@
+/**
+ * HTTP client for the Todo AI backend API.
+ */
+const apiUrl = process.env.TODO_AI_API_URL || "http://localhost:4000";
+const apiToken = process.env.TODO_AI_TOKEN;
+if (!apiToken) {
+    console.error("TODO_AI_TOKEN is required. Generate one at your Todo AI app or via POST /api/auth/api-token");
+    process.exit(1);
+}
+const headers = {
+    "Content-Type": "application/json",
+    Authorization: `Bearer ${apiToken}`,
+};
+export async function apiGet(path) {
+    const res = await fetch(`${apiUrl}${path}`, { headers });
+    const data = await res.json();
+    return { ok: res.ok, status: res.status, data: data };
+}
+export async function apiPost(path, body) {
+    const res = await fetch(`${apiUrl}${path}`, {
+        method: "POST",
+        headers,
+        body: body ? JSON.stringify(body) : undefined,
+    });
+    const data = await res.json();
+    return { ok: res.ok, status: res.status, data: data };
+}
+export async function apiPut(path, body) {
+    const res = await fetch(`${apiUrl}${path}`, {
+        method: "PUT",
+        headers,
+        body: JSON.stringify(body),
+    });
+    const data = await res.json();
+    return { ok: res.ok, status: res.status, data: data };
+}
+export async function apiDelete(path) {
+    const res = await fetch(`${apiUrl}${path}`, {
+        method: "DELETE",
+        headers,
+    });
+    if (res.status === 204) {
+        return { ok: true, status: 204, data: null };
+    }
+    const data = await res.json();
+    return { ok: res.ok, status: res.status, data: data };
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,212 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { apiGet, apiPost, apiPut, apiDelete } from "./api-client.js";
+const server = new McpServer({
+    name: "todo-ai",
+    version: "1.0.0",
+});
+// ── Todo Tools ──────────────────────────────────────────────────────────
+server.tool("list_todos", "List all todos for the authenticated user. Returns todos with title, description, category, priority, and status.", {}, async () => {
+    const res = await apiGet("/api/todos");
+    if (!res.ok) {
+        return { content: [{ type: "text", text: `Error: ${JSON.stringify(res.data)}` }], isError: true };
+    }
+    return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+});
+server.tool("get_todo", "Get a specific todo by ID", {
+    id: z.string().describe("The UUID of the todo"),
+}, async ({ id }) => {
+    const res = await apiGet(`/api/todos/${id}`);
+    if (!res.ok) {
+        return { content: [{ type: "text", text: `Error: ${JSON.stringify(res.data)}` }], isError: true };
+    }
+    return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+});
+server.tool("create_todo", "Create a new todo item. Use this when the user wants to track a task, bug, feature, or any work item.", {
+    title: z.string().describe("Title of the todo"),
+    description: z.string().optional().describe("Detailed description"),
+    category: z
+        .enum(["development", "design", "meeting", "review", "personal"])
+        .optional()
+        .describe("Category (default: development)"),
+    priority: z
+        .enum(["low", "medium", "high"])
+        .optional()
+        .describe("Priority level (default: medium)"),
+}, async ({ title, description, category, priority }) => {
+    const todo = { title };
+    if (description)
+        todo.description = description;
+    if (category)
+        todo.category = category;
+    if (priority)
+        todo.priority = priority;
+    const res = await apiPost("/api/todos", { todo });
+    if (!res.ok) {
+        return { content: [{ type: "text", text: `Error: ${JSON.stringify(res.data)}` }], isError: true };
+    }
+    return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+});
+server.tool("update_todo", "Update an existing todo's title, description, category, priority, or status", {
+    id: z.string().describe("The UUID of the todo to update"),
+    title: z.string().optional().describe("New title"),
+    description: z.string().optional().describe("New description"),
+    category: z
+        .enum(["development", "design", "meeting", "review", "personal"])
+        .optional()
+        .describe("New category"),
+    priority: z
+        .enum(["low", "medium", "high"])
+        .optional()
+        .describe("New priority"),
+    status: z
+        .enum(["pending", "completed"])
+        .optional()
+        .describe("New status"),
+}, async ({ id, title, description, category, priority, status }) => {
+    const todo = {};
+    if (title)
+        todo.title = title;
+    if (description)
+        todo.description = description;
+    if (category)
+        todo.category = category;
+    if (priority)
+        todo.priority = priority;
+    if (status)
+        todo.status = status;
+    const res = await apiPut(`/api/todos/${id}`, { todo });
+    if (!res.ok) {
+        return { content: [{ type: "text", text: `Error: ${JSON.stringify(res.data)}` }], isError: true };
+    }
+    return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+});
+server.tool("complete_todo", "Mark a todo as completed", {
+    id: z.string().describe("The UUID of the todo to complete"),
+}, async ({ id }) => {
+    const res = await apiPut(`/api/todos/${id}`, {
+        todo: { status: "completed", completed_at: new Date().toISOString() },
+    });
+    if (!res.ok) {
+        return { content: [{ type: "text", text: `Error: ${JSON.stringify(res.data)}` }], isError: true };
+    }
+    return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+});
+server.tool("delete_todo", "Delete a todo item permanently", {
+    id: z.string().describe("The UUID of the todo to delete"),
+}, async ({ id }) => {
+    const res = await apiDelete(`/api/todos/${id}`);
+    if (!res.ok) {
+        return { content: [{ type: "text", text: `Error: ${JSON.stringify(res.data)}` }], isError: true };
+    }
+    return { content: [{ type: "text", text: "Todo deleted successfully." }] };
+});
+server.tool("get_todos_by_date", "Get all todos for a specific date", {
+    date: z.string().describe("Date in YYYY-MM-DD format"),
+}, async ({ date }) => {
+    const res = await apiGet(`/api/todos/by-date/${date}`);
+    if (!res.ok) {
+        return { content: [{ type: "text", text: `Error: ${JSON.stringify(res.data)}` }], isError: true };
+    }
+    return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+});
+server.tool("get_todos_by_range", "Get all todos within a date range", {
+    start_date: z.string().describe("Start date in YYYY-MM-DD format"),
+    end_date: z.string().describe("End date in YYYY-MM-DD format"),
+}, async ({ start_date, end_date }) => {
+    const res = await apiGet(`/api/todos/by-range?start_date=${start_date}&end_date=${end_date}`);
+    if (!res.ok) {
+        return { content: [{ type: "text", text: `Error: ${JSON.stringify(res.data)}` }], isError: true };
+    }
+    return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+});
+// ── Summary Tools ───────────────────────────────────────────────────────
+server.tool("get_today_summary", "Get today's daily achievement summary", {}, async () => {
+    const res = await apiGet("/api/summaries/today");
+    if (!res.ok) {
+        return { content: [{ type: "text", text: `Error: ${JSON.stringify(res.data)}` }], isError: true };
+    }
+    return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+});
+server.tool("list_summaries", "List all daily summaries", {}, async () => {
+    const res = await apiGet("/api/summaries");
+    if (!res.ok) {
+        return { content: [{ type: "text", text: `Error: ${JSON.stringify(res.data)}` }], isError: true };
+    }
+    return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+});
+server.tool("create_summary", "Create a daily achievement summary", {
+    date: z.string().describe("Date in YYYY-MM-DD format"),
+    achievements: z.string().describe("Description of achievements for the day"),
+    notes: z.string().optional().describe("Additional notes"),
+    mood: z
+        .enum(["great", "good", "okay", "tough"])
+        .optional()
+        .describe("How the day went (default: good)"),
+    completed_count: z.number().optional().describe("Number of tasks completed"),
+}, async ({ date, achievements, notes, mood, completed_count }) => {
+    const summary = { date, achievements };
+    if (notes)
+        summary.notes = notes;
+    if (mood)
+        summary.mood = mood;
+    if (completed_count !== undefined)
+        summary.completed_count = completed_count;
+    const res = await apiPost("/api/summaries", { summary });
+    if (!res.ok) {
+        return { content: [{ type: "text", text: `Error: ${JSON.stringify(res.data)}` }], isError: true };
+    }
+    return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+});
+// ── Review Tools ────────────────────────────────────────────────────────
+server.tool("get_current_review", "Get the current week's performance review", {}, async () => {
+    const res = await apiGet("/api/reviews/current");
+    if (!res.ok) {
+        return { content: [{ type: "text", text: `Error: ${JSON.stringify(res.data)}` }], isError: true };
+    }
+    return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+});
+server.tool("list_reviews", "List all weekly performance reviews", {}, async () => {
+    const res = await apiGet("/api/reviews");
+    if (!res.ok) {
+        return { content: [{ type: "text", text: `Error: ${JSON.stringify(res.data)}` }], isError: true };
+    }
+    return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+});
+// ── AI Tools ────────────────────────────────────────────────────────────
+server.tool("get_recommendations", "Get AI-powered productivity recommendations based on your todo history", {}, async () => {
+    const res = await apiPost("/api/ai/recommendations");
+    if (!res.ok) {
+        return { content: [{ type: "text", text: `Error: ${JSON.stringify(res.data)}` }], isError: true };
+    }
+    return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+});
+server.tool("generate_daily_summary", "Use AI to generate a daily summary from completed tasks", {
+    date: z.string().describe("Date in YYYY-MM-DD format"),
+}, async ({ date }) => {
+    const res = await apiPost("/api/ai/generate-summary", { date });
+    if (!res.ok) {
+        return { content: [{ type: "text", text: `Error: ${JSON.stringify(res.data)}` }], isError: true };
+    }
+    return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+});
+server.tool("generate_weekly_review", "Use AI to generate a weekly performance review", {
+    week_start: z.string().describe("Start of week date in YYYY-MM-DD format"),
+}, async ({ week_start }) => {
+    const res = await apiPost("/api/ai/generate-review", { week_start });
+    if (!res.ok) {
+        return { content: [{ type: "text", text: `Error: ${JSON.stringify(res.data)}` }], isError: true };
+    }
+    return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+});
+// ── Start Server ────────────────────────────────────────────────────────
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@cyb3rk1d/todo-ai-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for Todo AI - allows Claude Code to manage your todo list",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "todo-ai-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "claude-code",
+    "model-context-protocol",
+    "todo",
+    "todo-ai",
+    "productivity",
+    "cyb3rk1d",
+    "gary-kamoto-mhone"
+  ],
+  "author": "Gary Kamoto Mhone (cyb3rk1d)",
+  "license": "MIT",
+  "homepage": "https://cybers-todo.vercel.app",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ZedTechInfo/todo-ai.git",
+    "directory": "mcp-server"
+  },
+  "bugs": {
+    "url": "https://github.com/ZedTechInfo/todo-ai/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^3.24.4"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.3",
+    "@types/node": "^22.15.2"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ]
+}