@createtodo/mcp 0.1.0

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.js

@@ -0,0 +1,575 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+
+// src/tools/comments.ts
+import { z } from "zod";
+
+// src/client.ts
+var API_URL = "https://api.createtodo.com";
+var API_KEY = process.env.API_KEY || "";
+async function apiRequest(path, options = {}) {
+  const { method = "GET", body, params } = options;
+  const url = new URL(path, API_URL);
+  if (params) {
+    for (const [key, value] of Object.entries(params)) {
+      url.searchParams.set(key, value);
+    }
+  }
+  const headers = {
+    "x-api-key": API_KEY
+  };
+  if (body) {
+    headers["Content-Type"] = "application/json";
+  }
+  const response = await fetch(url.toString(), {
+    method,
+    headers,
+    body: body ? JSON.stringify(body) : void 0
+  });
+  if (!response.ok) {
+    const errorText = await response.text();
+    throw new Error(`API error ${response.status}: ${errorText}`);
+  }
+  return response.json();
+}
+
+// src/tools/comments.ts
+var commentTools = {
+  list_comments: {
+    description: "List all comments in the workspace. Returns comments from the Electric SQL shape proxy. To find comments for a specific todo, filter the results by issue_id.",
+    inputSchema: z.object({}),
+    handler: async () => {
+      const result = await apiRequest("/shape", {
+        params: { table: "comments" }
+      });
+      return JSON.stringify(result, null, 2);
+    }
+  },
+  create_comment: {
+    description: "Add a comment to a todo",
+    inputSchema: z.object({
+      todoId: z.string().describe("The ID of the todo to comment on"),
+      body: z.string().describe("The comment text (markdown supported)")
+    }),
+    handler: async ({ todoId, body }) => {
+      const id = crypto.randomUUID();
+      const now = (/* @__PURE__ */ new Date()).toISOString();
+      const result = await apiRequest("/apply-changes", {
+        method: "POST",
+        body: {
+          todos: [],
+          comments: [
+            {
+              id,
+              issue_id: todoId,
+              body,
+              body_data: null,
+              parent_id: null,
+              created_at: now,
+              updated_at: now,
+              modified_columns: ["body", "issue_id"],
+              new: true
+            }
+          ],
+          containers: [],
+          teams: [],
+          labels: [],
+          workflow_states: [],
+          custom_fields: [],
+          todo_labels: []
+        }
+      });
+      return JSON.stringify({ id, ...result }, null, 2);
+    }
+  }
+};
+
+// src/tools/labels.ts
+import { z as z2 } from "zod";
+var labelTools = {
+  list_labels: {
+    description: "List all labels in the workspace. Uses the Electric SQL shape proxy to fetch label data.",
+    inputSchema: z2.object({}),
+    handler: async () => {
+      const result = await apiRequest("/shape", {
+        params: { table: "labels" }
+      });
+      return JSON.stringify(result, null, 2);
+    }
+  },
+  create_label: {
+    description: "Create a new label",
+    inputSchema: z2.object({
+      name: z2.string().describe("Name of the label"),
+      color: z2.string().describe("Color hex code (e.g., #ff0000)"),
+      description: z2.string().optional().describe("Description of the label")
+    }),
+    handler: async (input) => {
+      const id = crypto.randomUUID();
+      const now = (/* @__PURE__ */ new Date()).toISOString();
+      const modifiedColumns = ["name", "color"];
+      if (input.description) modifiedColumns.push("description");
+      const result = await apiRequest("/apply-changes", {
+        method: "POST",
+        body: {
+          todos: [],
+          comments: [],
+          containers: [],
+          teams: [],
+          labels: [
+            {
+              id,
+              name: input.name,
+              color: input.color,
+              description: input.description ?? null,
+              created_at: now,
+              updated_at: now,
+              modified_columns: modifiedColumns,
+              new: true
+            }
+          ],
+          workflow_states: [],
+          custom_fields: [],
+          todo_labels: []
+        }
+      });
+      return JSON.stringify({ id, ...result }, null, 2);
+    }
+  },
+  assign_label: {
+    description: "Assign a label to a todo",
+    inputSchema: z2.object({
+      todoId: z2.string().describe("The ID of the todo"),
+      labelId: z2.string().describe("The ID of the label to assign")
+    }),
+    handler: async ({
+      todoId,
+      labelId
+    }) => {
+      const now = (/* @__PURE__ */ new Date()).toISOString();
+      const result = await apiRequest("/apply-changes", {
+        method: "POST",
+        body: {
+          todos: [],
+          comments: [],
+          containers: [],
+          teams: [],
+          labels: [],
+          workflow_states: [],
+          custom_fields: [],
+          todo_labels: [
+            {
+              todo_id: todoId,
+              label_id: labelId,
+              created_at: now,
+              modified_columns: ["todo_id", "label_id"],
+              new: true
+            }
+          ]
+        }
+      });
+      return JSON.stringify(result, null, 2);
+    }
+  },
+  remove_label: {
+    description: "Remove a label from a todo",
+    inputSchema: z2.object({
+      todoId: z2.string().describe("The ID of the todo"),
+      labelId: z2.string().describe("The ID of the label to remove")
+    }),
+    handler: async ({
+      todoId,
+      labelId
+    }) => {
+      const now = (/* @__PURE__ */ new Date()).toISOString();
+      const result = await apiRequest("/apply-changes", {
+        method: "POST",
+        body: {
+          todos: [],
+          comments: [],
+          containers: [],
+          teams: [],
+          labels: [],
+          workflow_states: [],
+          custom_fields: [],
+          todo_labels: [
+            {
+              todo_id: todoId,
+              label_id: labelId,
+              deleted_at: now,
+              modified_columns: ["deleted_at"],
+              new: false
+            }
+          ]
+        }
+      });
+      return JSON.stringify(result, null, 2);
+    }
+  }
+};
+
+// src/tools/lists.ts
+import { z as z3 } from "zod";
+var listTools = {
+  list_lists: {
+    description: "List all todo lists in the workspace",
+    inputSchema: z3.object({}),
+    handler: async () => {
+      const result = await apiRequest("/todo-lists");
+      return JSON.stringify(result.todoLists, null, 2);
+    }
+  },
+  get_list: {
+    description: "Get a specific list with its todo items",
+    inputSchema: z3.object({
+      listId: z3.string().describe("The ID of the list")
+    }),
+    handler: async ({ listId }) => {
+      const result = await apiRequest(`/todo-lists/${listId}`);
+      return JSON.stringify(result, null, 2);
+    }
+  },
+  create_list: {
+    description: "Create a new todo list",
+    inputSchema: z3.object({
+      name: z3.string().describe("Name of the list"),
+      description: z3.string().optional().describe("Description of the list"),
+      color: z3.string().optional().describe("Color hex code (e.g., #ff0000)"),
+      icon: z3.string().optional().describe("Icon identifier")
+    }),
+    handler: async (input) => {
+      const id = crypto.randomUUID();
+      const now = (/* @__PURE__ */ new Date()).toISOString();
+      const modifiedColumns = ["name", "type"];
+      if (input.description) modifiedColumns.push("description");
+      if (input.color) modifiedColumns.push("color");
+      if (input.icon) modifiedColumns.push("icon");
+      const result = await apiRequest("/apply-changes", {
+        method: "POST",
+        body: {
+          todos: [],
+          comments: [],
+          containers: [
+            {
+              id,
+              name: input.name,
+              description: input.description ?? null,
+              type: "list",
+              color: input.color ?? null,
+              icon: input.icon ?? null,
+              created_at: now,
+              updated_at: now,
+              modified_columns: modifiedColumns,
+              new: true
+            }
+          ],
+          teams: [],
+          labels: [],
+          workflow_states: [],
+          custom_fields: [],
+          todo_labels: []
+        }
+      });
+      return JSON.stringify({ id, ...result }, null, 2);
+    }
+  },
+  update_list: {
+    description: "Update an existing list",
+    inputSchema: z3.object({
+      id: z3.string().describe("The ID of the list to update"),
+      name: z3.string().optional().describe("New name"),
+      description: z3.string().optional().describe("New description"),
+      color: z3.string().optional().describe("New color hex code"),
+      icon: z3.string().optional().describe("New icon"),
+      isArchived: z3.boolean().optional().describe("Archive or unarchive the list"),
+      isPinned: z3.boolean().optional().describe("Pin or unpin the list")
+    }),
+    handler: async (input) => {
+      const now = (/* @__PURE__ */ new Date()).toISOString();
+      const modifiedColumns = [];
+      const change = {
+        id: input.id,
+        updated_at: now,
+        new: false
+      };
+      if (input.name !== void 0) {
+        change.name = input.name;
+        modifiedColumns.push("name");
+      }
+      if (input.description !== void 0) {
+        change.description = input.description;
+        modifiedColumns.push("description");
+      }
+      if (input.color !== void 0) {
+        change.color = input.color;
+        modifiedColumns.push("color");
+      }
+      if (input.icon !== void 0) {
+        change.icon = input.icon;
+        modifiedColumns.push("icon");
+      }
+      if (input.isArchived !== void 0) {
+        change.is_archived = input.isArchived;
+        modifiedColumns.push("is_archived");
+      }
+      if (input.isPinned !== void 0) {
+        change.is_pinned = input.isPinned;
+        modifiedColumns.push("is_pinned");
+      }
+      change.modified_columns = modifiedColumns;
+      const result = await apiRequest("/apply-changes", {
+        method: "POST",
+        body: {
+          todos: [],
+          comments: [],
+          containers: [change],
+          teams: [],
+          labels: [],
+          workflow_states: [],
+          custom_fields: [],
+          todo_labels: []
+        }
+      });
+      return JSON.stringify(result, null, 2);
+    }
+  }
+};
+
+// src/tools/todos.ts
+import { z as z4 } from "zod";
+var todoTools = {
+  list_todos: {
+    description: "List todos in a specific list/container",
+    inputSchema: z4.object({
+      listId: z4.string().describe("The ID of the list to get todos from")
+    }),
+    handler: async ({ listId }) => {
+      const result = await apiRequest(
+        `/todo-lists/${listId}`
+      );
+      return JSON.stringify(result.todoList, null, 2);
+    }
+  },
+  create_todo: {
+    description: "Create a new todo item in a list with optional description, priority, assignee, and state.",
+    inputSchema: z4.object({
+      name: z4.string().describe("The title of the todo"),
+      containerId: z4.string().describe("The ID of the list/container to add the todo to"),
+      description: z4.string().optional().describe("Description of the todo"),
+      priority: z4.enum(["low", "medium", "high", "urgent"]).optional().describe("Priority level"),
+      assigneeId: z4.string().optional().describe("Member ID to assign the todo to"),
+      stateId: z4.string().optional().describe("Workflow state ID")
+    }),
+    handler: async (input) => {
+      const id = crypto.randomUUID();
+      const now = (/* @__PURE__ */ new Date()).toISOString();
+      const modifiedColumns = ["name", "container_id"];
+      if (input.description) modifiedColumns.push("description");
+      if (input.priority) modifiedColumns.push("priority");
+      if (input.assigneeId) modifiedColumns.push("assignee_id");
+      if (input.stateId) modifiedColumns.push("state_id");
+      const result = await apiRequest("/apply-changes", {
+        method: "POST",
+        body: {
+          todos: [
+            {
+              id,
+              name: input.name,
+              container_id: input.containerId,
+              description: input.description ?? null,
+              priority: input.priority ?? null,
+              assignee_id: input.assigneeId ?? null,
+              state_id: input.stateId ?? null,
+              created_at: now,
+              updated_at: now,
+              modified_columns: modifiedColumns,
+              new: true
+            }
+          ],
+          comments: [],
+          containers: [],
+          teams: [],
+          labels: [],
+          workflow_states: [],
+          custom_fields: [],
+          todo_labels: []
+        }
+      });
+      return JSON.stringify({ id, ...result }, null, 2);
+    }
+  },
+  update_todo: {
+    description: "Update an existing todo item",
+    inputSchema: z4.object({
+      id: z4.string().describe("The ID of the todo to update"),
+      name: z4.string().optional().describe("New title"),
+      description: z4.string().optional().describe("New description"),
+      priority: z4.enum(["low", "medium", "high", "urgent"]).optional().describe("New priority"),
+      assigneeId: z4.string().optional().describe("New assignee member ID"),
+      stateId: z4.string().optional().describe("New workflow state ID"),
+      containerId: z4.string().optional().describe("Move to a different list/container")
+    }),
+    handler: async (input) => {
+      const now = (/* @__PURE__ */ new Date()).toISOString();
+      const modifiedColumns = [];
+      const change = {
+        id: input.id,
+        updated_at: now,
+        new: false
+      };
+      if (input.name !== void 0) {
+        change.name = input.name;
+        modifiedColumns.push("name");
+      }
+      if (input.description !== void 0) {
+        change.description = input.description;
+        modifiedColumns.push("description");
+      }
+      if (input.priority !== void 0) {
+        change.priority = input.priority;
+        modifiedColumns.push("priority");
+      }
+      if (input.assigneeId !== void 0) {
+        change.assignee_id = input.assigneeId;
+        modifiedColumns.push("assignee_id");
+      }
+      if (input.stateId !== void 0) {
+        change.state_id = input.stateId;
+        modifiedColumns.push("state_id");
+      }
+      if (input.containerId !== void 0) {
+        change.container_id = input.containerId;
+        modifiedColumns.push("container_id");
+      }
+      change.modified_columns = modifiedColumns;
+      const result = await apiRequest("/apply-changes", {
+        method: "POST",
+        body: {
+          todos: [change],
+          comments: [],
+          containers: [],
+          teams: [],
+          labels: [],
+          workflow_states: [],
+          custom_fields: [],
+          todo_labels: []
+        }
+      });
+      return JSON.stringify(result, null, 2);
+    }
+  },
+  delete_todo: {
+    description: "Delete a todo item (soft delete)",
+    inputSchema: z4.object({
+      id: z4.string().describe("The ID of the todo to delete")
+    }),
+    handler: async ({ id }) => {
+      const now = (/* @__PURE__ */ new Date()).toISOString();
+      const result = await apiRequest("/apply-changes", {
+        method: "POST",
+        body: {
+          todos: [
+            {
+              id,
+              deleted_at: now,
+              updated_at: now,
+              modified_columns: ["deleted_at"],
+              new: false
+            }
+          ],
+          comments: [],
+          containers: [],
+          teams: [],
+          labels: [],
+          workflow_states: [],
+          custom_fields: [],
+          todo_labels: []
+        }
+      });
+      return JSON.stringify(result, null, 2);
+    }
+  }
+};
+
+// src/tools/workspace.ts
+import { z as z5 } from "zod";
+var workspaceTools = {
+  list_workflow_states: {
+    description: "List all workflow states (e.g., Todo, In Progress, Done) in the workspace",
+    inputSchema: z5.object({}),
+    handler: async () => {
+      const result = await apiRequest("/shape", {
+        params: { table: "workflow_states" }
+      });
+      return JSON.stringify(result, null, 2);
+    }
+  },
+  list_teams: {
+    description: "List all teams in the workspace",
+    inputSchema: z5.object({}),
+    handler: async () => {
+      const result = await apiRequest("/shape", {
+        params: { table: "teams" }
+      });
+      return JSON.stringify(result, null, 2);
+    }
+  },
+  list_members: {
+    description: "List all members in the workspace",
+    inputSchema: z5.object({}),
+    handler: async () => {
+      const result = await apiRequest("/shape", {
+        params: { table: "members" }
+      });
+      return JSON.stringify(result, null, 2);
+    }
+  }
+};
+
+// src/index.ts
+var server = new McpServer({
+  name: "createtodo",
+  version: "1.0.0"
+});
+var allTools = {
+  ...todoTools,
+  ...listTools,
+  ...labelTools,
+  ...commentTools,
+  ...workspaceTools
+};
+for (const [name, tool] of Object.entries(allTools)) {
+  server.tool(
+    name,
+    tool.description,
+    tool.inputSchema.shape,
+    async (params) => {
+      try {
+        const result = await tool.handler(params);
+        return { content: [{ type: "text", text: result }] };
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+          content: [{ type: "text", text: `Error: ${message}` }],
+          isError: true
+        };
+      }
+    }
+  );
+}
+async function main() {
+  if (!process.env.API_KEY) {
+    console.error("Error: API_KEY environment variable is required");
+    process.exit(1);
+  }
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("createtodo MCP server running on stdio");
+}
+main().catch((error) => {
+  console.error("Fatal error:", error);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@createtodo/mcp",
+  "version": "0.1.0",
+  "description": "MCP server for managing createtodo tasks, lists, labels, and more",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/martinory/frosa",
+    "directory": "apps/createtodo/packages/mcp"
+  },
+  "homepage": "https://createtodo.com",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "createtodo",
+    "todo",
+    "task-management",
+    "ai-tools"
+  ],
+  "bin": {
+    "createtodo-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --clean",
+    "prepublishOnly": "pnpm build",
+    "dev": "tsx src/index.ts"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.4.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.9.3"
+  }
+}