1 files changed, 145 insertions, 0 deletions
diff --git a/apps/mcp/src/lists.ts b/apps/mcp/src/lists.ts
new file mode 100644
index 00000000..6cfe1d13
--- /dev/null
+++ b/apps/mcp/src/lists.ts
@@ -0,0 +1,145 @@
+import { CallToolResult } from "@modelcontextprotocol/sdk/types";
+import { z } from "zod";
+
+import { karakeepClient, mcpServer, toMcpToolError } from "./shared";
+
+mcpServer.tool(
+  "get-lists",
+  `Search for bookmarks matching a specific a query.`,
+  async (): Promise<CallToolResult> => {
+    const res = await karakeepClient.GET("/lists");
+    if (!res.data) {
+      return toMcpToolError(res.error);
+    }
+    return {
+      content: res.data.lists.map((list) => ({
+        type: "text",
+        text: JSON.stringify(list),
+      })),
+    };
+  },
+);
+
+mcpServer.tool(
+  "get-bookmarks-in-list",
+  `Search for bookmarks matching a specific a query.`,
+  {
+    listId: z.string().describe(`The listId to search in.`),
+  },
+  async ({ listId }): Promise<CallToolResult> => {
+    const res = await karakeepClient.GET(`/lists/{listId}/bookmarks`, {
+      params: {
+        path: {
+          listId,
+        },
+      },
+    });
+    if (res.error) {
+      return toMcpToolError(res.error);
+    }
+    return {
+      content: res.data.bookmarks.map((bookmark) => ({
+        type: "text",
+        text: JSON.stringify(bookmark),
+      })),
+    };
+  },
+);
+
+mcpServer.tool(
+  "add-bookmark-to-list",
+  `Add a bookmark to a list.`,
+  {
+    listId: z.string().describe(`The listId to add the bookmark to.`),
+    bookmarkId: z.string().describe(`The bookmarkId to add.`),
+  },
+  async ({ listId, bookmarkId }): Promise<CallToolResult> => {
+    const res = await karakeepClient.PUT(
+      `/lists/{listId}/bookmarks/{bookmarkId}`,
+      {
+        params: {
+          path: {
+            listId,
+            bookmarkId,
+          },
+        },
+      },
+    );
+    if (res.error) {
+      return toMcpToolError(res.error);
+    }
+    return {
+      content: [
+        {
+          type: "text",
+          text: `Bookmark ${bookmarkId} added to list ${listId}`,
+        },
+      ],
+    };
+  },
+);
+
+mcpServer.tool(
+  "remove-bookmark-from-list",
+  `Remove a bookmark from a list.`,
+  {
+    listId: z.string().describe(`The listId to remove the bookmark from.`),
+    bookmarkId: z.string().describe(`The bookmarkId to remove.`),
+  },
+  async ({ listId, bookmarkId }): Promise<CallToolResult> => {
+    const res = await karakeepClient.DELETE(
+      `/lists/{listId}/bookmarks/{bookmarkId}`,
+      {
+        params: {
+          path: {
+            listId,
+            bookmarkId,
+          },
+        },
+      },
+    );
+    if (res.error) {
+      return toMcpToolError(res.error);
+    }
+    return {
+      content: [
+        {
+          type: "text",
+          text: `Bookmark ${bookmarkId} removed from list ${listId}`,
+        },
+      ],
+    };
+  },
+);
+
+mcpServer.tool(
+  "create-list",
+  `Create a list.`,
+  {
+    name: z.string().describe(`The name of the list.`),
+    icon: z.string().describe(`The emoji icon of the list.`),
+    parentId: z
+      .string()
+      .optional()
+      .describe(`The parent list id of this list.`),
+  },
+  async ({ name, icon }): Promise<CallToolResult> => {
+    const res = await karakeepClient.POST("/lists", {
+      body: {
+        name,
+        icon,
+      },
+    });
+    if (res.error) {
+      return toMcpToolError(res.error);
+    }
+    return {
+      content: [
+        {
+          type: "text",
+          text: `List ${name} created with id ${res.data.id}`,
+        },
+      ],
+    };
+  },
+);