Skip to content

A self-hostable bookmark-everything app (links, notes and images) with AI-based automatic tagging and full text search

feat(mcp): add list CRUD, tag CRUD, delete-bookmark (#2917)

Joe Stump831d6bf548c0
diff --git a/apps/mcp/README.md b/apps/mcp/README.md
index 45b0d79f..1e170e3b 100644
--- a/apps/mcp/README.md
+++ b/apps/mcp/README.md
@@ -5,11 +5,28 @@ with Karakeep from other tools.
## Supported Tools
-- Searching bookmarks
-- Adding and removing bookmarks from lists
-- Attaching and detaching tags to bookmarks
-- Creating new lists
-- Creating text and URL bookmarks
+**Bookmarks**
+- Searching bookmarks (`search-bookmarks`)
+- Reading a bookmark (`get-bookmark`, `get-bookmark-content`)
+- Creating text and URL bookmarks (`create-bookmark`)
+- Updating a bookmark (`update-bookmark`)
+- Deleting a bookmark (`delete-bookmark`)
+
+**Lists**
+- Listing all lists (`get-lists`)
+- Retrieving a single list (`get-list`)
+- Creating a list (`create-list`)
+- Updating a list (`update-list`) — name, icon, description, parentId, query, public; field constraints (length caps, smart-query validation) are inherited from the shared schema
+- Deleting a list (`delete-list`) — child lists are NOT deleted with the parent; they keep their parentId pointing at the deleted list
+- Adding and removing bookmarks from lists (`add-bookmark-to-list`, `remove-bookmark-from-list`)
+
+**Tags**
+- Listing tags with filters / pagination (`get-tags`)
+- Retrieving a single tag with usage counts (`get-tag`)
+- Renaming a tag (`update-tag`)
+- Deleting a tag (`delete-tag`) — bookmarks that had the tag are not deleted
+- Listing the bookmarks attached to a tag (`get-tag-bookmarks`)
+- Attaching and detaching tags on bookmarks (`attach-tag-to-bookmark`, `detach-tag-from-bookmark`)
Currently, the MCP server only exposes tools (no resources).
diff --git a/apps/mcp/package.json b/apps/mcp/package.json
index 972ef17d..215bda59 100644
--- a/apps/mcp/package.json
+++ b/apps/mcp/package.json
@@ -14,13 +14,15 @@
"karakeep-mcp": "dist/index.js"
},
"devDependencies": {
+ "@karakeep/shared": "workspace:*",
"@karakeep/tsconfig": "workspace:^0.1.0",
"@tsconfig/node22": "^22.0.0",
"@types/turndown": "^5.0.5",
"shx": "^0.4.0",
"tsx": "^4.8.1",
"vite": "^7.0.6",
- "vite-tsconfig-paths": "^6.1.1"
+ "vite-tsconfig-paths": "^6.1.1",
+ "vitest": "^3.2.4"
},
"scripts": {
"build": "vite build && shx chmod +x dist/index.js",
@@ -29,6 +31,7 @@
"lint:fix": "oxlint --ignore-path=../../.gitignore . --fix",
"format": "oxfmt --ignore-path=../../.gitignore --ignore-path=./.gitignore --check .",
"format:fix": "oxfmt --ignore-path=../../.gitignore --ignore-path=./.gitignore .",
+ "test": "vitest",
"typecheck": "tsc --noEmit"
},
"repository": {
diff --git a/apps/mcp/src/bookmarks.test.ts b/apps/mcp/src/bookmarks.test.ts
new file mode 100644
index 00000000..3c8eadef
--- /dev/null
+++ b/apps/mcp/src/bookmarks.test.ts
@@ -0,0 +1,228 @@
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+
+const { mockClient, mockTool, mockTurndown } = vi.hoisted(() => ({
+ mockClient: {
+ GET: vi.fn(),
+ POST: vi.fn(),
+ PUT: vi.fn(),
+ PATCH: vi.fn(),
+ DELETE: vi.fn(),
+ },
+ mockTool: vi.fn(),
+ mockTurndown: { turndown: vi.fn((s: string) => s) },
+}));
+
+vi.mock("./shared", () => ({
+ karakeepClient: mockClient,
+ mcpServer: { tool: mockTool },
+ turndownService: mockTurndown,
+}));
+
+import { deleteBookmarkHandler, getBookmarkContentHandler } from "./bookmarks";
+
+const textOf = (result: CallToolResult): string => {
+ const first = result.content[0];
+ if (!first || first.type !== "text") {
+ throw new Error(`expected text content, got ${JSON.stringify(first)}`);
+ }
+ return first.text;
+};
+
+const sampleBookmark = {
+ id: "bookmark_1",
+ createdAt: "2026-01-01T00:00:00Z",
+ modifiedAt: "2026-01-01T00:00:00Z",
+ title: "Rust async book",
+ archived: false,
+ favourited: false,
+ taggingStatus: "success" as const,
+ note: null,
+ summary: null,
+ tags: [],
+ content: {
+ type: "link" as const,
+ url: "https://example.com",
+ title: "Sample",
+ description: null,
+ author: null,
+ publisher: null,
+ datePublished: null,
+ dateModified: null,
+ imageUrl: null,
+ imageAssetId: null,
+ screenshotAssetId: null,
+ fullPageArchiveAssetId: null,
+ videoAssetId: null,
+ favicon: null,
+ htmlContent: null,
+ crawledAt: null,
+ crawlStatus: null,
+ crawlStatusCode: null,
+ contentAssetId: null,
+ },
+ assets: [],
+};
+
+beforeEach(() => {
+ mockClient.GET.mockReset();
+ mockClient.POST.mockReset();
+ mockClient.PUT.mockReset();
+ mockClient.PATCH.mockReset();
+ mockClient.DELETE.mockReset();
+});
+
+afterEach(() => {
+ vi.clearAllMocks();
+});
+
+describe("delete-bookmark", () => {
+ it("fetches the bookmark, deletes it, and reports the title", async () => {
+ mockClient.GET.mockResolvedValueOnce({
+ data: sampleBookmark,
+ error: undefined,
+ });
+ mockClient.DELETE.mockResolvedValueOnce({
+ data: undefined,
+ error: undefined,
+ });
+
+ const result = await deleteBookmarkHandler({ bookmarkId: "bookmark_1" });
+
+ expect(mockClient.GET).toHaveBeenCalledWith("/bookmarks/{bookmarkId}", {
+ params: {
+ path: { bookmarkId: "bookmark_1" },
+ query: { includeContent: false },
+ },
+ });
+ expect(mockClient.DELETE).toHaveBeenCalledWith("/bookmarks/{bookmarkId}", {
+ params: { path: { bookmarkId: "bookmark_1" } },
+ });
+ const text = textOf(result);
+ expect(text).toContain("Rust async book");
+ expect(text).toContain("bookmark_1");
+ });
+
+ it("falls back to id when bookmark has no title", async () => {
+ const titleless = {
+ ...sampleBookmark,
+ title: null,
+ content: { ...sampleBookmark.content, title: null },
+ };
+ mockClient.GET.mockResolvedValueOnce({ data: titleless, error: undefined });
+ mockClient.DELETE.mockResolvedValueOnce({
+ data: undefined,
+ error: undefined,
+ });
+
+ const result = await deleteBookmarkHandler({ bookmarkId: "bookmark_1" });
+
+ expect(textOf(result)).toContain(`"bookmark_1"`);
+ });
+
+ it("skips DELETE when the bookmark is not found", async () => {
+ mockClient.GET.mockResolvedValueOnce({
+ data: undefined,
+ error: { code: "NOT_FOUND", message: "Bookmark not found" },
+ });
+
+ const result = await deleteBookmarkHandler({ bookmarkId: "missing" });
+
+ expect(mockClient.DELETE).not.toHaveBeenCalled();
+ expect(result.isError).toBe(true);
+ });
+
+ it("surfaces DELETE failure", async () => {
+ mockClient.GET.mockResolvedValueOnce({
+ data: sampleBookmark,
+ error: undefined,
+ });
+ mockClient.DELETE.mockResolvedValueOnce({
+ data: undefined,
+ error: { code: "INTERNAL", message: "boom" },
+ });
+
+ const result = await deleteBookmarkHandler({ bookmarkId: "bookmark_1" });
+
+ expect(result.isError).toBe(true);
+ });
+});
+
+describe("get-bookmark-content", () => {
+ it("coerces null htmlContent to empty string before turndown (regression for #2914)", async () => {
+ mockTurndown.turndown.mockClear();
+ mockClient.GET.mockResolvedValueOnce({
+ data: {
+ ...sampleBookmark,
+ content: {
+ ...sampleBookmark.content,
+ htmlContent: null,
+ },
+ },
+ error: undefined,
+ });
+
+ const result = await getBookmarkContentHandler({
+ bookmarkId: "bookmark_1",
+ });
+
+ expect(mockTurndown.turndown).toHaveBeenCalledWith("");
+ expect(result.isError).toBeFalsy();
+ expect(textOf(result)).toBe("");
+ });
+
+ it("passes htmlContent through to turndown when it is a string", async () => {
+ mockTurndown.turndown.mockClear();
+ mockTurndown.turndown.mockReturnValueOnce("# rendered");
+ mockClient.GET.mockResolvedValueOnce({
+ data: {
+ ...sampleBookmark,
+ content: {
+ ...sampleBookmark.content,
+ htmlContent: "<h1>hello</h1>",
+ },
+ },
+ error: undefined,
+ });
+
+ const result = await getBookmarkContentHandler({
+ bookmarkId: "bookmark_1",
+ });
+
+ expect(mockTurndown.turndown).toHaveBeenCalledWith("<h1>hello</h1>");
+ expect(textOf(result)).toBe("# rendered");
+ });
+
+ it("returns text content directly for text bookmarks (no turndown call)", async () => {
+ mockTurndown.turndown.mockClear();
+ mockClient.GET.mockResolvedValueOnce({
+ data: {
+ ...sampleBookmark,
+ content: {
+ type: "text" as const,
+ text: "the stored text",
+ sourceUrl: null,
+ },
+ },
+ error: undefined,
+ });
+
+ const result = await getBookmarkContentHandler({
+ bookmarkId: "bookmark_1",
+ });
+
+ expect(mockTurndown.turndown).not.toHaveBeenCalled();
+ expect(textOf(result)).toBe("the stored text");
+ });
+
+ it("surfaces an MCP error when the bookmark is not found", async () => {
+ mockClient.GET.mockResolvedValueOnce({
+ data: undefined,
+ error: { code: "NOT_FOUND", message: "Bookmark not found" },
+ });
+
+ const result = await getBookmarkContentHandler({ bookmarkId: "missing" });
+
+ expect(result.isError).toBe(true);
+ });
+});
diff --git a/apps/mcp/src/bookmarks.ts b/apps/mcp/src/bookmarks.ts
index a88d6617..824cff22 100644
--- a/apps/mcp/src/bookmarks.ts
+++ b/apps/mcp/src/bookmarks.ts
@@ -60,7 +60,7 @@ machine learning is:fav`),
{
type: "text",
text: `
-${res.data.bookmarks.map(compactBookmark).join("\n\n")}
+${res.data.bookmarks.map((bm) => compactBookmark(bm)).join("\n\n")}
Next cursor: ${res.data.nextCursor ? `'${res.data.nextCursor}'` : "no more pages"}
`,
@@ -224,42 +224,89 @@ mcpServer.tool(
},
);
+export const getBookmarkContentInputSchema = {
+ bookmarkId: z.string().describe(`The bookmarkId to get content for.`),
+};
+
+export async function getBookmarkContentHandler({
+ bookmarkId,
+}: {
+ bookmarkId: string;
+}): Promise<CallToolResult> {
+ const res = await karakeepClient.GET(`/bookmarks/{bookmarkId}`, {
+ params: {
+ path: { bookmarkId },
+ query: { includeContent: true },
+ },
+ });
+ if (!res.data) {
+ return toMcpToolError(res.error);
+ }
+ let content;
+ if (res.data.content.type === "link") {
+ const htmlContent = res.data.content.htmlContent;
+ content = turndownService.turndown(htmlContent ?? "");
+ } else if (res.data.content.type === "text") {
+ content = res.data.content.text;
+ } else if (res.data.content.type === "asset") {
+ content = res.data.content.content;
+ }
+ return {
+ content: [
+ {
+ type: "text",
+ text: content ?? "",
+ },
+ ],
+ };
+}
+
mcpServer.tool(
"get-bookmark-content",
`Get the content of the bookmark in markdown`,
- {
- bookmarkId: z.string().describe(`The bookmarkId to get content for.`),
- },
- async ({ bookmarkId }): Promise<CallToolResult> => {
- const res = await karakeepClient.GET(`/bookmarks/{bookmarkId}`, {
- params: {
- path: {
- bookmarkId,
- },
- query: {
- includeContent: true,
- },
+ getBookmarkContentInputSchema,
+ getBookmarkContentHandler,
+);
+
+export const deleteBookmarkInputSchema = {
+ bookmarkId: z.string().min(1).describe(`The id of the bookmark to delete.`),
+};
+
+export async function deleteBookmarkHandler({
+ bookmarkId,
+}: {
+ bookmarkId: string;
+}): Promise<CallToolResult> {
+ const getRes = await karakeepClient.GET("/bookmarks/{bookmarkId}", {
+ params: { path: { bookmarkId }, query: { includeContent: false } },
+ });
+ if (!getRes.data) {
+ return toMcpToolError(getRes.error);
+ }
+ const { id } = getRes.data;
+ const titleFromContent =
+ getRes.data.content.type === "link" ? getRes.data.content.title : undefined;
+ const label = getRes.data.title ?? titleFromContent ?? id;
+
+ const delRes = await karakeepClient.DELETE("/bookmarks/{bookmarkId}", {
+ params: { path: { bookmarkId: id } },
+ });
+ if (delRes.error) {
+ return toMcpToolError(delRes.error);
+ }
+ return {
+ content: [
+ {
+ type: "text",
+ text: `Deleted bookmark "${label}" (id: ${id}).`,
},
- });
- if (!res.data) {
- return toMcpToolError(res.error);
- }
- let content;
- if (res.data.content.type === "link") {
- const htmlContent = res.data.content.htmlContent;
- content = turndownService.turndown(htmlContent ?? "");
- } else if (res.data.content.type === "text") {
- content = res.data.content.text;
- } else if (res.data.content.type === "asset") {
- content = res.data.content.content;
- }
- return {
- content: [
- {
- type: "text",
- text: content ?? "",
- },
- ],
- };
- },
+ ],
+ };
+}
+
+mcpServer.tool(
+ "delete-bookmark",
+ `Delete a bookmark by id. This is destructive — the bookmark, its highlights, and its assets are removed.`,
+ deleteBookmarkInputSchema,
+ deleteBookmarkHandler,
);
diff --git a/apps/mcp/src/lists.test.ts b/apps/mcp/src/lists.test.ts
new file mode 100644
index 00000000..803f1cb6
--- /dev/null
+++ b/apps/mcp/src/lists.test.ts
@@ -0,0 +1,216 @@
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+
+const { mockClient, mockTool } = vi.hoisted(() => ({
+ mockClient: {
+ GET: vi.fn(),
+ POST: vi.fn(),
+ PUT: vi.fn(),
+ PATCH: vi.fn(),
+ DELETE: vi.fn(),
+ },
+ mockTool: vi.fn(),
+}));
+
+vi.mock("./shared", () => ({
+ karakeepClient: mockClient,
+ mcpServer: { tool: mockTool },
+}));
+
+import { deleteListHandler, getListHandler, updateListHandler } from "./lists";
+
+const textOf = (result: CallToolResult): string => {
+ const first = result.content[0];
+ if (!first || first.type !== "text") {
+ throw new Error(`expected text content, got ${JSON.stringify(first)}`);
+ }
+ return first.text;
+};
+
+const sampleList = {
+ id: "list_123",
+ name: "Reading",
+ icon: "📚",
+ type: "manual" as const,
+ description: "Saved articles",
+ parentId: null,
+ query: null,
+ public: false,
+ hasCollaborators: false,
+ userRole: "owner" as const,
+};
+
+beforeEach(() => {
+ mockClient.GET.mockReset();
+ mockClient.POST.mockReset();
+ mockClient.PUT.mockReset();
+ mockClient.PATCH.mockReset();
+ mockClient.DELETE.mockReset();
+});
+
+afterEach(() => {
+ vi.clearAllMocks();
+});
+
+describe("get-list", () => {
+ it("returns formatted list details on success", async () => {
+ mockClient.GET.mockResolvedValueOnce({
+ data: sampleList,
+ error: undefined,
+ });
+
+ const result = await getListHandler({ listId: "list_123" });
+
+ expect(mockClient.GET).toHaveBeenCalledWith("/lists/{listId}", {
+ params: { path: { listId: "list_123" } },
+ });
+ expect(result.isError).toBeFalsy();
+ const text = textOf(result);
+ expect(text).toContain("List ID: list_123");
+ expect(text).toContain("Name: Reading");
+ expect(text).toContain("Type: manual");
+ expect(text).toContain("Public: false");
+ });
+
+ it("returns an MCP error when the list is not found", async () => {
+ mockClient.GET.mockResolvedValueOnce({
+ data: undefined,
+ error: { code: "NOT_FOUND", message: "List not found" },
+ });
+
+ const result = await getListHandler({ listId: "missing" });
+
+ expect(result.isError).toBe(true);
+ expect(textOf(result)).toContain("NOT_FOUND");
+ });
+});
+
+describe("update-list", () => {
+ it("sends only the provided fields and returns the updated list", async () => {
+ const updated = { ...sampleList, name: "Reading list", icon: "📖" };
+ mockClient.PATCH.mockResolvedValueOnce({ data: updated, error: undefined });
+
+ const result = await updateListHandler({
+ listId: "list_123",
+ name: "Reading list",
+ icon: "📖",
+ });
+
+ expect(mockClient.PATCH).toHaveBeenCalledWith("/lists/{listId}", {
+ params: { path: { listId: "list_123" } },
+ body: { name: "Reading list", icon: "📖" },
+ });
+ expect(result.isError).toBeFalsy();
+ expect(textOf(result)).toContain("List list_123 updated.");
+ });
+
+ it("preserves explicit nulls for nullable fields like parentId", async () => {
+ mockClient.PATCH.mockResolvedValueOnce({
+ data: sampleList,
+ error: undefined,
+ });
+
+ await updateListHandler({ listId: "list_123", parentId: null });
+
+ expect(mockClient.PATCH).toHaveBeenCalledWith("/lists/{listId}", {
+ params: { path: { listId: "list_123" } },
+ body: { parentId: null },
+ });
+ });
+
+ it("rejects calls with no updatable fields", async () => {
+ const result = await updateListHandler({ listId: "list_123" });
+
+ expect(mockClient.PATCH).not.toHaveBeenCalled();
+ expect(result.isError).toBe(true);
+ expect(textOf(result)).toMatch(/requires at least one field/i);
+ });
+
+ it("rejects a list trying to parent itself (shared refinement)", async () => {
+ const result = await updateListHandler({
+ listId: "list_123",
+ parentId: "list_123",
+ });
+
+ expect(mockClient.PATCH).not.toHaveBeenCalled();
+ expect(result.isError).toBe(true);
+ expect(textOf(result)).toMatch(/can't be its own parent/i);
+ });
+
+ it("rejects an invalid smart-list query (shared refinement)", async () => {
+ const result = await updateListHandler({
+ listId: "list_123",
+ query: "not a valid #search query at all",
+ });
+
+ expect(mockClient.PATCH).not.toHaveBeenCalled();
+ expect(result.isError).toBe(true);
+ });
+
+ it("returns an MCP error when the list is not found", async () => {
+ mockClient.PATCH.mockResolvedValueOnce({
+ data: undefined,
+ error: { code: "NOT_FOUND", message: "List not found" },
+ });
+
+ const result = await updateListHandler({
+ listId: "missing",
+ name: "x",
+ });
+
+ expect(result.isError).toBe(true);
+ });
+});
+
+describe("delete-list", () => {
+ it("fetches the list, deletes it, and returns name + id", async () => {
+ mockClient.GET.mockResolvedValueOnce({
+ data: sampleList,
+ error: undefined,
+ });
+ mockClient.DELETE.mockResolvedValueOnce({
+ data: undefined,
+ error: undefined,
+ });
+
+ const result = await deleteListHandler({ listId: "list_123" });
+
+ expect(mockClient.GET).toHaveBeenCalledWith("/lists/{listId}", {
+ params: { path: { listId: "list_123" } },
+ });
+ expect(mockClient.DELETE).toHaveBeenCalledWith("/lists/{listId}", {
+ params: { path: { listId: "list_123" } },
+ });
+ expect(result.isError).toBeFalsy();
+ const text = textOf(result);
+ expect(text).toContain("Reading");
+ expect(text).toContain("list_123");
+ });
+
+ it("returns an MCP error and does not call DELETE when the list is not found", async () => {
+ mockClient.GET.mockResolvedValueOnce({
+ data: undefined,
+ error: { code: "NOT_FOUND", message: "List not found" },
+ });
+
+ const result = await deleteListHandler({ listId: "missing" });
+
+ expect(mockClient.DELETE).not.toHaveBeenCalled();
+ expect(result.isError).toBe(true);
+ });
+
+ it("returns an MCP error when DELETE itself fails", async () => {
+ mockClient.GET.mockResolvedValueOnce({
+ data: sampleList,
+ error: undefined,
+ });
+ mockClient.DELETE.mockResolvedValueOnce({
+ data: undefined,
+ error: { code: "INTERNAL", message: "boom" },
+ });
+
+ const result = await deleteListHandler({ listId: "list_123" });
+
+ expect(result.isError).toBe(true);
+ });
+});
diff --git a/apps/mcp/src/lists.ts b/apps/mcp/src/lists.ts
index d5fd181c..f2995bc9 100644
--- a/apps/mcp/src/lists.ts
+++ b/apps/mcp/src/lists.ts
@@ -1,8 +1,25 @@
import { CallToolResult } from "@modelcontextprotocol/sdk/types";
import { z } from "zod";
+import type { KarakeepAPISchemas } from "@karakeep/sdk";
+import {
+ zEditBookmarkListSchema,
+ zEditBookmarkListSchemaWithValidation,
+} from "@karakeep/shared/types/lists";
+
import { karakeepClient, mcpServer } from "./shared";
-import { toMcpToolError } from "./utils";
+import { pickDefined, toMcpToolError } from "./utils";
+
+function formatList(list: KarakeepAPISchemas["List"]): string {
+ return `List ID: ${list.id}
+Name: ${list.name}
+Icon: ${list.icon}
+Type: ${list.type}
+Description: ${list.description ?? ""}
+Parent ID: ${list.parentId ?? ""}
+Query: ${list.query ?? ""}
+Public: ${list.public}`;
+}
mcpServer.tool(
"get-lists",
@@ -18,21 +35,160 @@ mcpServer.tool(
content: [
{
type: "text",
- text: res.data.lists
- .map(
- (list) => `List ID: ${list.id}
-Name: ${list.name}
-Icon: ${list.icon}
-Description: ${list.description ?? ""}
-Parent ID: ${list.parentId}`,
- )
- .join("\n\n"),
+ text: res.data.lists.map(formatList).join("\n\n"),
},
],
};
},
);
+export const getListInputSchema = {
+ listId: z.string().min(1).describe(`The id of the list to retrieve.`),
+};
+
+export async function getListHandler({
+ listId,
+}: {
+ listId: string;
+}): Promise<CallToolResult> {
+ const res = await karakeepClient.GET("/lists/{listId}", {
+ params: { path: { listId } },
+ });
+ if (!res.data) {
+ return toMcpToolError(res.error);
+ }
+ return {
+ content: [
+ {
+ type: "text",
+ text: formatList(res.data),
+ },
+ ],
+ };
+}
+
+mcpServer.tool(
+ "get-list",
+ `Retrieve a single list by its id.`,
+ getListInputSchema,
+ getListHandler,
+);
+
+const sharedListEditShape = zEditBookmarkListSchema.omit({
+ listId: true,
+}).shape;
+
+const updateListFields = {
+ name: sharedListEditShape.name.describe(`New name for the list.`),
+ icon: sharedListEditShape.icon.describe(`New emoji icon for the list.`),
+ description: sharedListEditShape.description.describe(
+ `New description for the list. Pass null to clear.`,
+ ),
+ parentId: sharedListEditShape.parentId.describe(
+ `New parent list id. Pass null to move to the root.`,
+ ),
+ query: sharedListEditShape.query.describe(
+ `New smart-list query. Only meaningful for smart lists.`,
+ ),
+ public: sharedListEditShape.public.describe(
+ `Whether the list is publicly accessible.`,
+ ),
+};
+
+export const updateListInputSchema = {
+ listId: z.string().min(1).describe(`The id of the list to update.`),
+ ...updateListFields,
+};
+
+export type UpdateListInput = z.infer<
+ z.ZodObject<typeof updateListInputSchema>
+>;
+type UpdateListBody = Omit<UpdateListInput, "listId">;
+
+export async function updateListHandler(
+ input: UpdateListInput,
+): Promise<CallToolResult> {
+ const refined = zEditBookmarkListSchemaWithValidation.safeParse(input);
+ if (!refined.success) {
+ const issue = refined.error.issues[0];
+ return toMcpToolError(issue?.message ?? "Invalid input for update-list");
+ }
+
+ const { listId, ...rest } = input;
+ const body: UpdateListBody = pickDefined(rest);
+
+ if (Object.keys(body).length === 0) {
+ return toMcpToolError(
+ `update-list requires at least one field to update (name, icon, description, parentId, query, or public).`,
+ );
+ }
+
+ const res = await karakeepClient.PATCH("/lists/{listId}", {
+ params: { path: { listId } },
+ body,
+ });
+ if (!res.data) {
+ return toMcpToolError(res.error);
+ }
+ return {
+ content: [
+ {
+ type: "text",
+ text: `List ${res.data.id} updated.
+
+${formatList(res.data)}`,
+ },
+ ],
+ };
+}
+
+mcpServer.tool(
+ "update-list",
+ `Update a list. Only the fields you pass are changed. Length caps and smart-list query rules come from the shared list schema.`,
+ updateListInputSchema,
+ updateListHandler,
+);
+
+export const deleteListInputSchema = {
+ listId: z.string().min(1).describe(`The id of the list to delete.`),
+};
+
+export async function deleteListHandler({
+ listId,
+}: {
+ listId: string;
+}): Promise<CallToolResult> {
+ const getRes = await karakeepClient.GET("/lists/{listId}", {
+ params: { path: { listId } },
+ });
+ if (!getRes.data) {
+ return toMcpToolError(getRes.error);
+ }
+ const { id, name } = getRes.data;
+
+ const delRes = await karakeepClient.DELETE("/lists/{listId}", {
+ params: { path: { listId: id } },
+ });
+ if (delRes.error) {
+ return toMcpToolError(delRes.error);
+ }
+ return {
+ content: [
+ {
+ type: "text",
+ text: `Deleted list "${name}" (id: ${id}).`,
+ },
+ ],
+ };
+}
+
+mcpServer.tool(
+ "delete-list",
+ `Delete a list by id. Bookmarks inside the list are not deleted. Child lists are also not deleted. Any child lists become root-level lists (their parentId is set to null). If that isn't the tree change you want, move or re-parent the children before calling this.`,
+ deleteListInputSchema,
+ deleteListHandler,
+);
+
mcpServer.tool(
"add-bookmark-to-list",
`Add a bookmark to a list.`,
diff --git a/apps/mcp/src/tags.test.ts b/apps/mcp/src/tags.test.ts
new file mode 100644
index 00000000..529c6774
--- /dev/null
+++ b/apps/mcp/src/tags.test.ts
@@ -0,0 +1,270 @@
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+
+const { mockClient, mockTool } = vi.hoisted(() => ({
+ mockClient: {
+ GET: vi.fn(),
+ POST: vi.fn(),
+ PUT: vi.fn(),
+ PATCH: vi.fn(),
+ DELETE: vi.fn(),
+ },
+ mockTool: vi.fn(),
+}));
+
+vi.mock("./shared", () => ({
+ karakeepClient: mockClient,
+ mcpServer: { tool: mockTool },
+}));
+
+import {
+ deleteTagHandler,
+ getTagBookmarksHandler,
+ getTagHandler,
+ getTagsHandler,
+ updateTagHandler,
+} from "./tags";
+
+const textOf = (result: CallToolResult): string => {
+ const first = result.content[0];
+ if (!first || first.type !== "text") {
+ throw new Error(`expected text content, got ${JSON.stringify(first)}`);
+ }
+ return first.text;
+};
+
+const sampleTag = {
+ id: "tag_42",
+ name: "rust",
+ numBookmarks: 7,
+ numBookmarksByAttachedType: { ai: 2, human: 5 },
+};
+
+const sampleBookmark = {
+ id: "bookmark_1",
+ createdAt: "2026-01-01T00:00:00Z",
+ modifiedAt: "2026-01-01T00:00:00Z",
+ title: "Sample",
+ archived: false,
+ favourited: false,
+ taggingStatus: "success" as const,
+ note: null,
+ summary: null,
+ tags: [{ id: "tag_42", name: "rust", attachedBy: "human" as const }],
+ content: {
+ type: "link" as const,
+ url: "https://example.com",
+ title: "Sample",
+ description: null,
+ author: null,
+ publisher: null,
+ datePublished: null,
+ dateModified: null,
+ imageUrl: null,
+ imageAssetId: null,
+ screenshotAssetId: null,
+ fullPageArchiveAssetId: null,
+ videoAssetId: null,
+ favicon: null,
+ htmlContent: null,
+ crawledAt: null,
+ crawlStatus: null,
+ crawlStatusCode: null,
+ contentAssetId: null,
+ },
+ assets: [],
+};
+
+beforeEach(() => {
+ mockClient.GET.mockReset();
+ mockClient.POST.mockReset();
+ mockClient.PUT.mockReset();
+ mockClient.PATCH.mockReset();
+ mockClient.DELETE.mockReset();
+});
+
+afterEach(() => {
+ vi.clearAllMocks();
+});
+
+describe("get-tags", () => {
+ it("returns formatted tags and forwards filters", async () => {
+ mockClient.GET.mockResolvedValueOnce({
+ data: { tags: [sampleTag], nextCursor: "abc" },
+ error: undefined,
+ });
+
+ const result = await getTagsHandler({
+ nameContains: "rust",
+ sort: "usage",
+ limit: 25,
+ });
+
+ expect(mockClient.GET).toHaveBeenCalledWith("/tags", {
+ params: { query: { nameContains: "rust", sort: "usage", limit: 25 } },
+ });
+ expect(result.isError).toBeFalsy();
+ const text = textOf(result);
+ expect(text).toContain("Tag ID: tag_42");
+ expect(text).toContain("Name: rust");
+ expect(text).toContain("Bookmarks: 7 (human: 5, ai: 2)");
+ expect(text).toContain("Next page cursor: abc");
+ });
+
+ it("omits cursor line when there is no next page", async () => {
+ mockClient.GET.mockResolvedValueOnce({
+ data: { tags: [sampleTag], nextCursor: null },
+ error: undefined,
+ });
+
+ const result = await getTagsHandler({});
+
+ expect(textOf(result)).not.toContain("Next page cursor");
+ });
+
+ it("returns MCP error on failure", async () => {
+ mockClient.GET.mockResolvedValueOnce({
+ data: undefined,
+ error: { code: "UNAUTHORIZED", message: "Bad token" },
+ });
+
+ const result = await getTagsHandler({});
+
+ expect(result.isError).toBe(true);
+ });
+});
+
+describe("get-tag", () => {
+ it("returns formatted tag", async () => {
+ mockClient.GET.mockResolvedValueOnce({ data: sampleTag, error: undefined });
+
+ const result = await getTagHandler({ tagId: "tag_42" });
+
+ expect(mockClient.GET).toHaveBeenCalledWith("/tags/{tagId}", {
+ params: { path: { tagId: "tag_42" } },
+ });
+ expect(textOf(result)).toContain("Tag ID: tag_42");
+ });
+
+ it("returns MCP error on 404", async () => {
+ mockClient.GET.mockResolvedValueOnce({
+ data: undefined,
+ error: { code: "NOT_FOUND", message: "Tag not found" },
+ });
+
+ const result = await getTagHandler({ tagId: "missing" });
+
+ expect(result.isError).toBe(true);
+ });
+});
+
+describe("update-tag", () => {
+ it("renames the tag and reports the new name", async () => {
+ mockClient.PATCH.mockResolvedValueOnce({
+ data: { id: "tag_42", name: "Rust" },
+ error: undefined,
+ });
+
+ const result = await updateTagHandler({ tagId: "tag_42", name: "Rust" });
+
+ expect(mockClient.PATCH).toHaveBeenCalledWith("/tags/{tagId}", {
+ params: { path: { tagId: "tag_42" } },
+ body: { name: "Rust" },
+ });
+ expect(textOf(result)).toContain(`Tag tag_42 renamed to "Rust"`);
+ });
+
+ it("returns MCP error when the tag is not found", async () => {
+ mockClient.PATCH.mockResolvedValueOnce({
+ data: undefined,
+ error: { code: "NOT_FOUND", message: "Tag not found" },
+ });
+
+ const result = await updateTagHandler({ tagId: "missing", name: "X" });
+
+ expect(result.isError).toBe(true);
+ });
+});
+
+describe("delete-tag", () => {
+ it("fetches the tag, deletes it, and reports the name", async () => {
+ mockClient.GET.mockResolvedValueOnce({ data: sampleTag, error: undefined });
+ mockClient.DELETE.mockResolvedValueOnce({
+ data: undefined,
+ error: undefined,
+ });
+
+ const result = await deleteTagHandler({ tagId: "tag_42" });
+
+ expect(mockClient.GET).toHaveBeenCalledWith("/tags/{tagId}", {
+ params: { path: { tagId: "tag_42" } },
+ });
+ expect(mockClient.DELETE).toHaveBeenCalledWith("/tags/{tagId}", {
+ params: { path: { tagId: "tag_42" } },
+ });
+ const text = textOf(result);
+ expect(text).toContain("rust");
+ expect(text).toContain("tag_42");
+ });
+
+ it("skips DELETE when GET returns 404", async () => {
+ mockClient.GET.mockResolvedValueOnce({
+ data: undefined,
+ error: { code: "NOT_FOUND", message: "Tag not found" },
+ });
+
+ const result = await deleteTagHandler({ tagId: "missing" });
+
+ expect(mockClient.DELETE).not.toHaveBeenCalled();
+ expect(result.isError).toBe(true);
+ });
+
+ it("surfaces DELETE failure", async () => {
+ mockClient.GET.mockResolvedValueOnce({ data: sampleTag, error: undefined });
+ mockClient.DELETE.mockResolvedValueOnce({
+ data: undefined,
+ error: { code: "INTERNAL", message: "boom" },
+ });
+
+ const result = await deleteTagHandler({ tagId: "tag_42" });
+
+ expect(result.isError).toBe(true);
+ });
+});
+
+describe("get-tag-bookmarks", () => {
+ it("forwards query params and returns formatted bookmarks", async () => {
+ mockClient.GET.mockResolvedValueOnce({
+ data: { bookmarks: [sampleBookmark], nextCursor: "next" },
+ error: undefined,
+ });
+
+ const result = await getTagBookmarksHandler({
+ tagId: "tag_42",
+ limit: 10,
+ sortOrder: "asc",
+ includeContent: true,
+ });
+
+ expect(mockClient.GET).toHaveBeenCalledWith("/tags/{tagId}/bookmarks", {
+ params: {
+ path: { tagId: "tag_42" },
+ query: { limit: 10, sortOrder: "asc", includeContent: true },
+ },
+ });
+ const text = textOf(result);
+ expect(text).toContain("Bookmark ID: bookmark_1");
+ expect(text).toContain("Next page cursor: next");
+ });
+
+ it("returns MCP error on 404", async () => {
+ mockClient.GET.mockResolvedValueOnce({
+ data: undefined,
+ error: { code: "NOT_FOUND", message: "Tag not found" },
+ });
+
+ const result = await getTagBookmarksHandler({ tagId: "missing" });
+
+ expect(result.isError).toBe(true);
+ });
+});
diff --git a/apps/mcp/src/tags.ts b/apps/mcp/src/tags.ts
index 57f1c3ba..a484f464 100644
--- a/apps/mcp/src/tags.ts
+++ b/apps/mcp/src/tags.ts
@@ -2,7 +2,12 @@ import { CallToolResult } from "@modelcontextprotocol/sdk/types";
import { z } from "zod";
import { karakeepClient, mcpServer } from "./shared";
-import { toMcpToolError } from "./utils";
+import {
+ compactBookmark,
+ compactTag,
+ pickDefined,
+ toMcpToolError,
+} from "./utils";
mcpServer.tool(
"attach-tag-to-bookmark",
@@ -67,3 +72,236 @@ mcpServer.tool(
};
},
);
+
+export const getTagsInputSchema = {
+ nameContains: z
+ .string()
+ .min(1)
+ .optional()
+ .describe(`Filter tags whose name contains this substring.`),
+ sort: z
+ .enum(["name", "usage", "relevance"])
+ .optional()
+ .describe(
+ `Sort order. 'relevance' requires nameContains. Defaults to 'usage'.`,
+ ),
+ attachedBy: z
+ .enum(["ai", "human", "none"])
+ .optional()
+ .describe(`Filter by how the tag was attached.`),
+ cursor: z
+ .string()
+ .min(1)
+ .optional()
+ .describe(`Cursor from a previous response to fetch the next page.`),
+ limit: z
+ .number()
+ .int()
+ .min(1)
+ .optional()
+ .describe(`Maximum number of items to return per page.`),
+};
+
+export type GetTagsInput = z.infer<z.ZodObject<typeof getTagsInputSchema>>;
+
+export async function getTagsHandler(
+ input: GetTagsInput,
+): Promise<CallToolResult> {
+ const res = await karakeepClient.GET("/tags", {
+ params: { query: pickDefined(input) },
+ });
+ if (!res.data) {
+ return toMcpToolError(res.error);
+ }
+ const cursorLine = res.data.nextCursor
+ ? `\n\nNext page cursor: ${res.data.nextCursor}`
+ : "";
+ return {
+ content: [
+ {
+ type: "text",
+ text: res.data.tags.map(compactTag).join("\n\n") + cursorLine,
+ },
+ ],
+ };
+}
+
+mcpServer.tool(
+ "get-tags",
+ `List tags with their bookmark counts. Supports filtering and pagination.`,
+ getTagsInputSchema,
+ getTagsHandler,
+);
+
+export const getTagInputSchema = {
+ tagId: z.string().min(1).describe(`The id of the tag to retrieve.`),
+};
+
+export async function getTagHandler({
+ tagId,
+}: {
+ tagId: string;
+}): Promise<CallToolResult> {
+ const res = await karakeepClient.GET("/tags/{tagId}", {
+ params: { path: { tagId } },
+ });
+ if (!res.data) {
+ return toMcpToolError(res.error);
+ }
+ return {
+ content: [{ type: "text", text: compactTag(res.data) }],
+ };
+}
+
+mcpServer.tool(
+ "get-tag",
+ `Retrieve a single tag by id, including its bookmark counts.`,
+ getTagInputSchema,
+ getTagHandler,
+);
+
+export const updateTagInputSchema = {
+ tagId: z.string().min(1).describe(`The id of the tag to update.`),
+ name: z
+ .string()
+ .min(1)
+ .describe(`New name for the tag. Will be normalized by the server.`),
+};
+
+export type UpdateTagInput = z.infer<z.ZodObject<typeof updateTagInputSchema>>;
+
+export async function updateTagHandler(
+ input: UpdateTagInput,
+): Promise<CallToolResult> {
+ const { tagId, name } = input;
+ const res = await karakeepClient.PATCH("/tags/{tagId}", {
+ params: { path: { tagId } },
+ body: { name },
+ });
+ if (!res.data) {
+ return toMcpToolError(res.error);
+ }
+ return {
+ content: [
+ {
+ type: "text",
+ text: `Tag ${res.data.id} renamed to "${res.data.name}".`,
+ },
+ ],
+ };
+}
+
+mcpServer.tool(
+ "update-tag",
+ `Rename a tag. The new name is normalized by the server.`,
+ updateTagInputSchema,
+ updateTagHandler,
+);
+
+export const deleteTagInputSchema = {
+ tagId: z.string().min(1).describe(`The id of the tag to delete.`),
+};
+
+export async function deleteTagHandler({
+ tagId,
+}: {
+ tagId: string;
+}): Promise<CallToolResult> {
+ const getRes = await karakeepClient.GET("/tags/{tagId}", {
+ params: { path: { tagId } },
+ });
+ if (!getRes.data) {
+ return toMcpToolError(getRes.error);
+ }
+ const { id, name } = getRes.data;
+
+ const delRes = await karakeepClient.DELETE("/tags/{tagId}", {
+ params: { path: { tagId: id } },
+ });
+ if (delRes.error) {
+ return toMcpToolError(delRes.error);
+ }
+ return {
+ content: [
+ {
+ type: "text",
+ text: `Deleted tag "${name}" (id: ${id}). Bookmarks previously tagged are not deleted.`,
+ },
+ ],
+ };
+}
+
+mcpServer.tool(
+ "delete-tag",
+ `Delete a tag by id. Bookmarks that had this tag are not deleted; the tag is just removed from them.`,
+ deleteTagInputSchema,
+ deleteTagHandler,
+);
+
+export const getTagBookmarksInputSchema = {
+ tagId: z
+ .string()
+ .min(1)
+ .describe(`The id of the tag whose bookmarks to fetch.`),
+ sortOrder: z
+ .enum(["asc", "desc"])
+ .optional()
+ .describe(`Sort order by creation date. Defaults to 'desc'.`),
+ limit: z
+ .number()
+ .int()
+ .min(1)
+ .optional()
+ .describe(`Maximum number of bookmarks to return per page.`),
+ cursor: z
+ .string()
+ .min(1)
+ .optional()
+ .describe(`Cursor from a previous response to fetch the next page.`),
+ includeContent: z
+ .boolean()
+ .optional()
+ .describe(
+ `If true, include each bookmark's full content. Defaults to false.`,
+ ),
+};
+
+export type GetTagBookmarksInput = z.infer<
+ z.ZodObject<typeof getTagBookmarksInputSchema>
+>;
+
+export async function getTagBookmarksHandler(
+ input: GetTagBookmarksInput,
+): Promise<CallToolResult> {
+ const { tagId, includeContent, ...query } = input;
+ const res = await karakeepClient.GET("/tags/{tagId}/bookmarks", {
+ params: {
+ path: { tagId },
+ query: pickDefined({ ...query, includeContent }),
+ },
+ });
+ if (!res.data) {
+ return toMcpToolError(res.error);
+ }
+ const cursorLine = res.data.nextCursor
+ ? `\n\nNext page cursor: ${res.data.nextCursor}`
+ : "";
+ return {
+ content: [
+ {
+ type: "text",
+ text:
+ res.data.bookmarks
+ .map((bm) => compactBookmark(bm, { includeContent }))
+ .join("\n\n") + cursorLine,
+ },
+ ],
+ };
+}
+
+mcpServer.tool(
+ "get-tag-bookmarks",
+ `List bookmarks that have a given tag, with pagination.`,
+ getTagBookmarksInputSchema,
+ getTagBookmarksHandler,
+);
diff --git a/apps/mcp/src/utils.test.ts b/apps/mcp/src/utils.test.ts
new file mode 100644
index 00000000..c926d47f
--- /dev/null
+++ b/apps/mcp/src/utils.test.ts
@@ -0,0 +1,132 @@
+import { describe, expect, it, vi } from "vitest";
+
+const { mockTurndown } = vi.hoisted(() => ({
+ mockTurndown: { turndown: vi.fn((s: string) => `md:${s}`) },
+}));
+
+vi.mock("./shared", () => ({
+ turndownService: mockTurndown,
+}));
+
+import { compactBookmark, compactTag, pickDefined } from "./utils";
+
+describe("pickDefined", () => {
+ it("strips undefined and preserves null + falsy values", () => {
+ const out = pickDefined({
+ a: "kept",
+ b: undefined,
+ c: null,
+ d: false,
+ e: 0,
+ f: "",
+ });
+ expect(out).toEqual({ a: "kept", c: null, d: false, e: 0, f: "" });
+ expect("b" in out).toBe(false);
+ });
+});
+
+describe("compactTag", () => {
+ it("renders human and ai sub-counts with zero fallbacks", () => {
+ const text = compactTag({
+ id: "tag_1",
+ name: "rust",
+ numBookmarks: 3,
+ numBookmarksByAttachedType: { human: 3 },
+ });
+ expect(text).toContain("Tag ID: tag_1");
+ expect(text).toContain("Bookmarks: 3 (human: 3, ai: 0)");
+ });
+});
+
+describe("compactBookmark", () => {
+ const base = {
+ id: "bookmark_1",
+ createdAt: "2026-01-01T00:00:00Z",
+ modifiedAt: "2026-01-01T00:00:00Z",
+ title: null,
+ archived: false,
+ favourited: false,
+ taggingStatus: "success" as const,
+ summarizationStatus: "success" as const,
+ embeddingStatus: "success" as const,
+ note: null,
+ summary: null,
+ userId: "user_1",
+ tags: [],
+ assets: [],
+ };
+
+ it("renders the Text: line for text-type bookmarks", () => {
+ const out = compactBookmark({
+ ...base,
+ content: {
+ type: "text",
+ text: "the actual stored text",
+ sourceUrl: null,
+ },
+ });
+ expect(out).toContain("Bookmark type: text");
+ expect(out).toContain("Text: the actual stored text");
+ });
+
+ it("does not emit a Text: line for link-type bookmarks", () => {
+ const out = compactBookmark({
+ ...base,
+ content: {
+ type: "link",
+ url: "https://example.com",
+ },
+ });
+ expect(out).toContain("Bookmark type: link");
+ expect(out).not.toContain("Text:");
+ });
+
+ it("appends turndown-rendered htmlContent for link bookmarks when includeContent is true", () => {
+ mockTurndown.turndown.mockClear();
+ const out = compactBookmark(
+ {
+ ...base,
+ content: {
+ type: "link",
+ url: "https://example.com",
+ htmlContent: "<p>hi</p>",
+ },
+ },
+ { includeContent: true },
+ );
+ expect(mockTurndown.turndown).toHaveBeenCalledWith("<p>hi</p>");
+ expect(out).toContain("Content: md:<p>hi</p>");
+ });
+
+ it("omits Content for link bookmarks when includeContent is false", () => {
+ mockTurndown.turndown.mockClear();
+ const out = compactBookmark({
+ ...base,
+ content: {
+ type: "link",
+ url: "https://example.com",
+ htmlContent: "<p>hi</p>",
+ },
+ });
+ expect(mockTurndown.turndown).not.toHaveBeenCalled();
+ expect(out).not.toContain("Content:");
+ });
+
+ it("appends the raw content field for asset bookmarks when includeContent is true", () => {
+ const out = compactBookmark(
+ {
+ ...base,
+ content: {
+ type: "asset",
+ assetType: "pdf",
+ assetId: "asset_1",
+ content: "extracted pdf text",
+ sourceUrl: null,
+ },
+ },
+ { includeContent: true },
+ );
+ expect(out).toContain("Bookmark type: media");
+ expect(out).toContain("Content: extracted pdf text");
+ });
+});
diff --git a/apps/mcp/src/utils.ts b/apps/mcp/src/utils.ts
index bffdd12e..b9f28be1 100644
--- a/apps/mcp/src/utils.ts
+++ b/apps/mcp/src/utils.ts
@@ -2,6 +2,8 @@ import { CallToolResult } from "@modelcontextprotocol/sdk/types";
import { KarakeepAPISchemas } from "@karakeep/sdk";
+import { turndownService } from "./shared";
+
export function toMcpToolError(
error: KarakeepAPISchemas["Error"] | string | undefined,
): CallToolResult {
@@ -21,9 +23,29 @@ export function toMcpToolError(
};
}
+export function pickDefined<T extends object>(input: T): Partial<T> {
+ const out: Partial<T> = {};
+ for (const key of Object.keys(input) as (keyof T)[]) {
+ if (input[key] !== undefined) {
+ out[key] = input[key];
+ }
+ }
+ return out;
+}
+
+export function compactTag(tag: KarakeepAPISchemas["Tag"]): string {
+ const aiCount = tag.numBookmarksByAttachedType.ai ?? 0;
+ const humanCount = tag.numBookmarksByAttachedType.human ?? 0;
+ return `Tag ID: ${tag.id}
+Name: ${tag.name}
+Bookmarks: ${tag.numBookmarks} (human: ${humanCount}, ai: ${aiCount})`;
+}
+
export function compactBookmark(
bookmark: KarakeepAPISchemas["Bookmark"],
+ options: { includeContent?: boolean } = {},
): string {
+ const includeContent = options.includeContent ?? false;
let content: string;
if (bookmark.content.type === "link") {
content = `Bookmark type: link
@@ -31,14 +53,21 @@ Bookmarked URL: ${bookmark.content.url}
description: ${bookmark.content.description ?? ""}
author: ${bookmark.content.author ?? ""}
publisher: ${bookmark.content.publisher ?? ""}`;
+ if (includeContent && bookmark.content.htmlContent) {
+ content += `\n Content: ${turndownService.turndown(bookmark.content.htmlContent)}`;
+ }
} else if (bookmark.content.type === "text") {
content = `Bookmark type: text
- Source URL: ${bookmark.content.sourceUrl ?? ""}`;
+ Source URL: ${bookmark.content.sourceUrl ?? ""}
+ Text: ${bookmark.content.text}`;
} else if (bookmark.content.type === "asset") {
content = `Bookmark type: media
Asset ID: ${bookmark.content.assetId}
Asset type: ${bookmark.content.assetType}
Source URL: ${bookmark.content.sourceUrl ?? ""}`;
+ if (includeContent && bookmark.content.content) {
+ content += `\n Content: ${bookmark.content.content}`;
+ }
} else {
content = `Bookmark type: unknown`;
}
diff --git a/apps/mcp/vitest.config.ts b/apps/mcp/vitest.config.ts
new file mode 100644
index 00000000..60b885b7
--- /dev/null
+++ b/apps/mcp/vitest.config.ts
@@ -0,0 +1,11 @@
+/// <reference types="vitest" />
+
+import tsconfigPaths from "vite-tsconfig-paths";
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+ plugins: [tsconfigPaths({ skip: (dir) => dir === ".claude" })],
+ test: {
+ include: ["src/**/*.test.ts"],
+ },
+});
diff --git a/docs/docs/05-integrations/03-mcp.md b/docs/docs/05-integrations/03-mcp.md
index 514332de..8ddcf8f9 100644
--- a/docs/docs/05-integrations/03-mcp.md
+++ b/docs/docs/05-integrations/03-mcp.md
@@ -4,11 +4,28 @@ Karakeep comes with a Model Context Protocol server that can be used to interact
## Supported Tools
-- Searching bookmarks
-- Adding and removing bookmarks from lists
-- Attaching and detaching tags to bookmarks
-- Creating new lists
-- Creating text and URL bookmarks
+**Bookmarks**
+- Searching bookmarks (`search-bookmarks`)
+- Reading a bookmark (`get-bookmark`, `get-bookmark-content`)
+- Creating text and URL bookmarks (`create-bookmark`)
+- Updating a bookmark (`update-bookmark`)
+- Deleting a bookmark (`delete-bookmark`)
+
+**Lists**
+- Listing all lists (`get-lists`)
+- Retrieving a single list (`get-list`)
+- Creating a list (`create-list`)
+- Updating a list (`update-list`) — name, icon, description, parentId, query, public; field constraints (length caps, smart-query validation) are inherited from the shared schema
+- Deleting a list (`delete-list`) — child lists are NOT deleted with the parent; they keep their parentId pointing at the deleted list
+- Adding and removing bookmarks from lists (`add-bookmark-to-list`, `remove-bookmark-from-list`)
+
+**Tags**
+- Listing tags with filters / pagination (`get-tags`)
+- Retrieving a single tag with usage counts (`get-tag`)
+- Renaming a tag (`update-tag`)
+- Deleting a tag (`delete-tag`) — bookmarks that had the tag are not deleted
+- Listing the bookmarks attached to a tag (`get-tag-bookmarks`)
+- Attaching and detaching tags on bookmarks (`attach-tag-to-bookmark`, `detach-tag-from-bookmark`)
## Usage with Claude Desktop
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 4bcea791..e208fef7 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -4,6 +4,9 @@ settings:
autoInstallPeers: true
excludeLinksFromLockfile: false
+overrides:
+ vite: 7.0.6
+
patchedDependencies:
[email protected]: cc2a1c1903e66d7f6cea77c615cb9ae3b36a694502c1c588c3e34d28aa925aac
[email protected]: d7b79c3ae412d8e700a8c176df42ee89112c9bdc91d2aad0ebb7d5b011b49993
@@ -148,7 +151,7 @@ importers:
specifier: ^5.9
version: 5.9.3
vite:
- specifier: ^7.0.6
+ specifier: 7.0.6
apps/cli:
@@ -190,7 +193,7 @@ importers:
specifier: ^4.8.1
version: 4.20.3
vite:
- specifier: ^7.0.6
+ specifier: 7.0.6
vite-tsconfig-paths:
specifier: ^6.1.1
@@ -267,7 +270,7 @@ importers:
version: 3.4.1
vite-plugin-svgr:
specifier: ^4.3.0
apps/mcp:
dependencies:
@@ -284,6 +287,9 @@ importers:
specifier: ^4.0.0
version: 4.3.6
devDependencies:
+ '@karakeep/shared':
+ specifier: workspace:*
+ version: link:../../packages/shared
'@karakeep/tsconfig':
specifier: workspace:^0.1.0
version: link:../../tooling/typescript
@@ -300,11 +306,14 @@ importers:
specifier: ^4.8.1
version: 4.20.3
vite:
- specifier: ^7.0.6
+ specifier: 7.0.6
vite-tsconfig-paths:
specifier: ^6.1.1
+ vitest:
+ specifier: ^3.2.4
apps/mobile:
dependencies:
@@ -852,7 +861,7 @@ importers:
version: 3.4.1
vite-tsconfig-paths:
specifier: ^6.1.1
vitest:
specifier: ^3.2.4
@@ -1152,7 +1161,7 @@ importers:
version: 0.0.32
vite-tsconfig-paths:
specifier: ^6.1.1
vitest:
specifier: ^3.2.4
@@ -1266,7 +1275,7 @@ importers:
version: 0.5.16
vite-tsconfig-paths:
specifier: ^6.1.1
vitest:
specifier: ^3.2.4
@@ -1319,7 +1328,7 @@ importers:
version: link:../../tooling/typescript
vite-tsconfig-paths:
specifier: ^6.1.1
vitest:
specifier: ^3.2.4
@@ -1343,7 +1352,7 @@ importers:
specifier: ^4.8.1
version: 4.20.3
vite:
- specifier: ^7.0.6
+ specifier: 7.0.6
vite-plugin-dts:
specifier: ^4.4.0
@@ -1396,7 +1405,7 @@ importers:
version: 6.4.17
vite-tsconfig-paths:
specifier: ^6.1.1
vitest:
specifier: ^3.2.4
@@ -1506,7 +1515,7 @@ importers:
version: link:../../tooling/typescript
vite-tsconfig-paths:
specifier: ^6.1.1
vitest:
specifier: ^3.2.4
@@ -1567,7 +1576,7 @@ importers:
version: 6.4.17
vite-tsconfig-paths:
specifier: ^6.1.1
vitest:
specifier: ^3.2.4
@@ -6537,108 +6546,54 @@ packages:
rollup:
optional: true
- '@rollup/[email protected]':
- resolution: {integrity: sha512-gldmAyS9hpj+H6LpRNlcjQWbuKUtb94lodB9uCz71Jm+7BxK1VIOo7y62tZZwxhA7j1ylv/yQz080L5WkS+LoQ==}
- cpu: [arm]
- os: [android]
-
'@rollup/[email protected]':
resolution: {integrity: sha512-d6FinEBLdIiK+1uACUttJKfgZREXrF0Qc2SmLII7W2AD8FfiZ9Wjd+rD/iRuf5s5dWrr1GgwXCvPqOuDquOowA==}
cpu: [arm]
os: [android]
- '@rollup/[email protected]':
- resolution: {integrity: sha512-bpRipfTgmGFdCZDFLRvIkSNO1/3RGS74aWkJJTFJBH7h3MRV4UijkaEUeOMbi9wxtxYmtAbVcnMtHTPBhLEkaw==}
- cpu: [arm64]
- os: [android]
-
'@rollup/[email protected]':
resolution: {integrity: sha512-YjG/EwIDvvYI1YvYbHvDz/BYHtkY4ygUIXHnTdLhG+hKIQFBiosfWiACWortsKPKU/+dUwQQCKQM3qrDe8c9BA==}
cpu: [arm64]
os: [android]
- '@rollup/[email protected]':
- resolution: {integrity: sha512-JxHtA081izPBVCHLKnl6GEA0w3920mlJPLh89NojpU2GsBSB6ypu4erFg/Wx1qbpUbepn0jY4dVWMGZM8gplgA==}
- cpu: [arm64]
- os: [darwin]
-
'@rollup/[email protected]':
resolution: {integrity: sha512-mjCpF7GmkRtSJwon+Rq1N8+pI+8l7w5g9Z3vWj4T7abguC4Czwi3Yu/pFaLvA3TTeMVjnu3ctigusqWUfjZzvw==}
cpu: [arm64]
os: [darwin]
- '@rollup/[email protected]':
- resolution: {integrity: sha512-rv5UZaWVIJTDMyQ3dCEK+m0SAn6G7H3PRc2AZmExvbDvtaDc+qXkei0knQWcI3+c9tEs7iL/4I4pTQoPbNL2SA==}
- cpu: [x64]
- os: [darwin]
-
'@rollup/[email protected]':
resolution: {integrity: sha512-haZ7hJ1JT4e9hqkoT9R/19XW2QKqjfJVv+i5AGg57S+nLk9lQnJ1F/eZloRO3o9Scy9CM3wQ9l+dkXtcBgN5Ew==}
cpu: [x64]
os: [darwin]
- '@rollup/[email protected]':
- resolution: {integrity: sha512-fJcN4uSGPWdpVmvLuMtALUFwCHgb2XiQjuECkHT3lWLZhSQ3MBQ9pq+WoWeJq2PrNxr9rPM1Qx+IjyGj8/c6zQ==}
- cpu: [arm64]
- os: [freebsd]
-
'@rollup/[email protected]':
resolution: {integrity: sha512-czw90wpQq3ZsAVBlinZjAYTKduOjTywlG7fEeWKUA7oCmpA8xdTkxZZlwNJKWqILlq0wehoZcJYfBvOyhPTQ6w==}
cpu: [arm64]
os: [freebsd]
- '@rollup/[email protected]':
- resolution: {integrity: sha512-CziHfyzpp8hJpCVE/ZdTizw58gr+m7Y2Xq5VOuCSrZR++th2xWAz4Nqk52MoIIrV3JHtVBhbBsJcAxs6NammOQ==}
- cpu: [x64]
- os: [freebsd]
-
'@rollup/[email protected]':
resolution: {integrity: sha512-KVB2rqsxTHuBtfOeySEyzEOB7ltlB/ux38iu2rBQzkjbwRVlkhAGIEDiiYnO2kFOkJp+Z7pUXKyrRRFuFUKt+g==}
cpu: [x64]
os: [freebsd]
- '@rollup/[email protected]':
- resolution: {integrity: sha512-UsQD5fyLWm2Fe5CDM7VPYAo+UC7+2Px4Y+N3AcPh/LdZu23YcuGPegQly++XEVaC8XUTFVPscl5y5Cl1twEI4A==}
- cpu: [arm]
- os: [linux]
- libc: [glibc]
-
'@rollup/[email protected]':
resolution: {integrity: sha512-L+34Qqil+v5uC0zEubW7uByo78WOCIrBvci69E7sFASRl0X7b/MB6Cqd1lky/CtcSVTydWa2WZwFuWexjS5o6g==}
cpu: [arm]
os: [linux]
libc: [glibc]
- '@rollup/[email protected]':
- resolution: {integrity: sha512-/i8NIrlgc/+4n1lnoWl1zgH7Uo0XK5xK3EDqVTf38KvyYgCU/Rm04+o1VvvzJZnVS5/cWSd07owkzcVasgfIkQ==}
- cpu: [arm]
- os: [linux]
- libc: [musl]
-
'@rollup/[email protected]':
resolution: {integrity: sha512-n83O8rt4v34hgFzlkb1ycniJh7IR5RCIqt6mz1VRJD6pmhRi0CXdmfnLu9dIUS6buzh60IvACM842Ffb3xd6Gg==}
cpu: [arm]
os: [linux]
libc: [musl]
- '@rollup/[email protected]':
- resolution: {integrity: sha512-eoujJFOvoIBjZEi9hJnXAbWg+Vo1Ov8n/0IKZZcPZ7JhBzxh2A+2NFyeMZIRkY9iwBvSjloKgcvnjTbGKHE44Q==}
- cpu: [arm64]
- os: [linux]
- libc: [glibc]
-
'@rollup/[email protected]':
resolution: {integrity: sha512-Nql7sTeAzhTAja3QXeAI48+/+GjBJ+QmAH13snn0AJSNL50JsDqotyudHyMbO2RbJkskbMbFJfIJKWA6R1LCJQ==}
cpu: [arm64]
os: [linux]
libc: [glibc]
- '@rollup/[email protected]':
- resolution: {integrity: sha512-/3NrcOWFSR7RQUQIuZQChLND36aTU9IYE4j+TB40VU78S+RA0IiqHR30oSh6P1S9f9/wVOenHQnacs/Byb824g==}
- cpu: [arm64]
- os: [linux]
- libc: [musl]
-
'@rollup/[email protected]':
resolution: {integrity: sha512-+pUymDhd0ys9GcKZPPWlFiZ67sTWV5UU6zOJat02M1+PiuSGDziyRuI/pPue3hoUwm2uGfxdL+trT6Z9rxnlMA==}
cpu: [arm64]
@@ -6657,18 +6612,6 @@ packages:
os: [linux]
libc: [musl]
- '@rollup/[email protected]':
- resolution: {integrity: sha512-O8AplvIeavK5ABmZlKBq9/STdZlnQo7Sle0LLhVA7QT+CiGpNVe197/t8Aph9bhJqbDVGCHpY2i7QyfEDDStDg==}
- cpu: [loong64]
- os: [linux]
- libc: [glibc]
-
- '@rollup/[email protected]':
- resolution: {integrity: sha512-6Qb66tbKVN7VyQrekhEzbHRxXXFFD8QKiFAwX5v9Xt6FiJ3BnCVBuyBxa2fkFGqxOCSGGYNejxd8ht+q5SnmtA==}
- cpu: [ppc64]
- os: [linux]
- libc: [glibc]
-
'@rollup/[email protected]':
resolution: {integrity: sha512-tLQQ9aPvkBxOc/EUT6j3pyeMD6Hb8QF2BTBnCQWP/uu1lhc9AIrIjKnLYMEroIz/JvtGYgI9dF3AxHZNaEH0rw==}
cpu: [ppc64]
@@ -6681,60 +6624,30 @@ packages:
os: [linux]
libc: [musl]
- '@rollup/[email protected]':
- resolution: {integrity: sha512-KQETDSEBamQFvg/d8jajtRwLNBlGc3aKpaGiP/LvEbnmVUKlFta1vqJqTrvPtsYsfbE/DLg5CC9zyXRX3fnBiA==}
- cpu: [riscv64]
- os: [linux]
- libc: [glibc]
-
'@rollup/[email protected]':
resolution: {integrity: sha512-QKgFl+Yc1eEk6MmOBfRHYF6lTxiiiV3/z/BRrbSiW2I7AFTXoBFvdMEyglohPj//2mZS4hDOqeB0H1ACh3sBbg==}
cpu: [riscv64]
os: [linux]
libc: [glibc]
- '@rollup/[email protected]':
- resolution: {integrity: sha512-qMvnyjcU37sCo/tuC+JqeDKSuukGAd+pVlRl/oyDbkvPJ3awk6G6ua7tyum02O3lI+fio+eM5wsVd66X0jQtxw==}
- cpu: [riscv64]
- os: [linux]
- libc: [musl]
-
'@rollup/[email protected]':
resolution: {integrity: sha512-RAjXjP/8c6ZtzatZcA1RaQr6O1TRhzC+adn8YZDnChliZHviqIjmvFwHcxi4JKPSDAt6Uhf/7vqcBzQJy0PDJg==}
cpu: [riscv64]
os: [linux]
libc: [musl]
- '@rollup/[email protected]':
- resolution: {integrity: sha512-I2Y1ZUgTgU2RLddUHXTIgyrdOwljjkmcZ/VilvaEumtS3Fkuhbw4p4hgHc39Ypwvo2o7sBFNl2MquNvGCa55Iw==}
- cpu: [s390x]
- os: [linux]
- libc: [glibc]
-
'@rollup/[email protected]':
resolution: {integrity: sha512-wcuocpaOlaL1COBYiA89O6yfjlp3RwKDeTIA0hM7OpmhR1Bjo9j31G1uQVpDlTvwxGn2nQs65fBFL5UFd76FcQ==}
cpu: [s390x]
os: [linux]
libc: [glibc]
- '@rollup/[email protected]':
- resolution: {integrity: sha512-Gfm6cV6mj3hCUY8TqWa63DB8Mx3NADoFwiJrMpoZ1uESbK8FQV3LXkhfry+8bOniq9pqY1OdsjFWNsSbfjPugw==}
- cpu: [x64]
- os: [linux]
- libc: [glibc]
-
'@rollup/[email protected]':
resolution: {integrity: sha512-77PpsFQUCOiZR9+LQEFg9GClyfkNXj1MP6wRnzYs0EeWbPcHs02AXu4xuUbM1zhwn3wqaizle3AEYg5aeoohhg==}
cpu: [x64]
os: [linux]
libc: [glibc]
- '@rollup/[email protected]':
- resolution: {integrity: sha512-g86PF8YZ9GRqkdi0VoGlcDUb4rYtQKyTD1IVtxxN4Hpe7YqLBShA7oHMKU6oKTCi3uxwW4VkIGnOaH/El8de3w==}
- cpu: [x64]
- os: [linux]
- libc: [musl]
-
'@rollup/[email protected]':
resolution: {integrity: sha512-5cIATbk5vynAjqqmyBjlciMJl1+R/CwX9oLk/EyiFXDWd95KpHdrOJT//rnUl4cUcskrd0jCCw3wpZnhIHdD9w==}
cpu: [x64]
@@ -6751,21 +6664,11 @@ packages:
cpu: [arm64]
os: [openharmony]
- '@rollup/[email protected]':
- resolution: {integrity: sha512-+axkdyDGSp6hjyzQ5m1pgcvQScfHnMCcsXkx8pTgy/6qBmWVhtRVlgxjWwDp67wEXXUr0x+vD6tp5W4x6V7u1A==}
- cpu: [arm64]
- os: [win32]
-
'@rollup/[email protected]':
resolution: {integrity: sha512-i1okWYkA4FJICtr7KpYzFpRTHgy5jdDbZiWfvny21iIKky5YExiDXP+zbXzm3dUcFpkEeYNHgQ5fuG236JPq0g==}
cpu: [arm64]
os: [win32]
- '@rollup/[email protected]':
- resolution: {integrity: sha512-F+5J9pelstXKwRSDq92J0TEBXn2nfUrQGg+HK1+Tk7VOL09e0gBqUHugZv7SW4MGrYj41oNCUe3IKCDGVlis2g==}
- cpu: [ia32]
- os: [win32]
-
'@rollup/[email protected]':
resolution: {integrity: sha512-u09m3CuwLzShA0EYKMNiFgcjjzwqtUMLmuCJLeZWjjOYA3IT2Di09KaxGBTP9xVztWyIWjVdsB2E9goMjZvTQg==}
cpu: [ia32]
@@ -6776,11 +6679,6 @@ packages:
cpu: [x64]
os: [win32]
- '@rollup/[email protected]':
- resolution: {integrity: sha512-LpHiJRwkaVz/LqjHjK8LCi8osq7elmpwujwbXKNW88bM8eeGxavJIKKjkjpMHAh/2xfnrt1ZSnhTv41WYUHYmA==}
- cpu: [x64]
- os: [win32]
-
'@rollup/[email protected]':
resolution: {integrity: sha512-lWMnixq/QzxyhTV6NjQJ4SFo1J6PvOX8vUx5Wb4bBPsEb+8xZ89Bz6kOXpfXj9ak9AHTQVQzlgzBEc1SyM27xQ==}
cpu: [x64]
@@ -7714,9 +7612,6 @@ packages:
resolution: {integrity: sha512-52CcUVNFyfb1A2ALocQw/Dd1BQFNmSdkuC3BkZ6iqhdMfQz7JWOFRuJFloOzjk+6WijU56m9oKXFAXc7o3Towg==}
- '@types/[email protected]':
- resolution: {integrity: sha512-w28IoSUCJpidD/TGviZwwMJckNESJZXFu7NBZ5YJ4mEUnNraUn9Pm8HSZm/jDF1pDWYKspWE7oVphigUPRakIQ==}
-
resolution: {integrity: sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==}
@@ -7974,13 +7869,13 @@ packages:
resolution: {integrity: sha512-NQhPjysi5duItyrMd5JWZFf2vNOuSMyw+EoZyTBDzk+DkfYD8WNrsUs09sELV2cr1P15nufsN25hsUBt4CKF9Q==}
engines: {node: ^20.19.0 || >=22.12.0}
peerDependencies:
- vite: ^4 || ^5 || ^6 || ^7
+ vite: 7.0.6
'@vitejs/[email protected]':
resolution: {integrity: sha512-YmKkfhOAi3wsB1PhJq5Scj3GXMn3WvtQ/JC0xoopuHoXSdmtdStOpFrYaT1kie2YgFBcIe64ROzMYRjCrYOdYw==}
engines: {node: ^20.19.0 || >=22.12.0}
peerDependencies:
- vite: ^4.2.0 || ^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0
+ vite: 7.0.6
'@vitest/[email protected]':
resolution: {integrity: sha512-Io0yyORnB6sikFlt8QW5K7slY4OjqNX9jmJQ02QDda8lyM6B5oNgVWoSoKPac8/kgnCUzuHQKrSLtu/uOqqrig==}
@@ -7989,7 +7884,7 @@ packages:
resolution: {integrity: sha512-46ryTE9RZO/rfDd7pEqFl7etuyzekzEhUbTW3BvmeO/BcCMEgq59BKhek3dXDWgAj4oMK6OZi+vRr1wPW6qjEQ==}
peerDependencies:
msw: ^2.4.9
- vite: ^5.0.0 || ^6.0.0 || ^7.0.0-0
+ vite: 7.0.6
peerDependenciesMeta:
msw:
optional: true
@@ -10657,14 +10552,6 @@ packages:
resolution: {integrity: sha512-ztsSx77JBtkuMrEypfhgc3cI0+0h+svqeie7xHbh1k/IKdcydnvadp/mUaGgjAOXQmQSxsqgaRhS3q9fy+1kxg==}
- resolution: {integrity: sha512-hiFoqpyZcfNm1yc4u8oWCf9A2c4D3QjCrks3zmoVKVxpQRzmPNar1hUJcBG2RQHvEVGDN+Jm81ZheVLAQMK6+w==}
- peerDependencies:
- picomatch: ^3 || ^4
- peerDependenciesMeta:
- picomatch:
- optional: true
-
resolution: {integrity: sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==}
engines: {node: '>=12.0.0'}
@@ -15494,11 +15381,6 @@ packages:
engines: {node: '>=10.0.0'}
hasBin: true
- resolution: {integrity: sha512-LW+Vse3BJPyGJGAJt1j8pWDKPd73QM8cRXYK1IxOBgL2AGLu7Xd2YOW0M2sLUBCkF5MshXXtMApyEAEzMVMsnw==}
- engines: {node: '>=18.0.0', npm: '>=8.0.0'}
- hasBin: true
-
resolution: {integrity: sha512-VmtB2rFU/GroZ4oL8+ZqXgSA38O6GR8KSIvWmEFv63pQ0G6KaBH9s07PO8XTXP4vI+3UJUEypOfjkGfmSBBR0w==}
engines: {node: '>=18.0.0', npm: '>=8.0.0'}
@@ -17050,7 +16932,7 @@ packages:
resolution: {integrity: sha512-d4sOM8M/8z7vRXHHq/ebbblfaxENjogAAekcfcDCCwAyvGqnPrc7f4NZbvItS+g4WTgerW0xDwSz5qz11JT3vg==}
peerDependencies:
typescript: '*'
- vite: '*'
+ vite: 7.0.6
peerDependenciesMeta:
vite:
optional: true
@@ -17058,12 +16940,12 @@ packages:
resolution: {integrity: sha512-Jy9qLB2/PyWklpYy0xk0UU3TlU0t2UMpJXZvf+hWII1lAmRHrOUKi11Uw8N3rxoNk7atZNYO3pR3vI1f7oi+6w==}
peerDependencies:
- vite: '>=2.6.0'
+ vite: 7.0.6
resolution: {integrity: sha512-2cihq7zliibCCZ8P9cKJrQBkfgdvcFkOOc3Y02o3GWUDLgqjWsZudaoiuOwO/gzTzy17cS5F7ZPo4bsnS4DGkg==}
peerDependencies:
- vite: '*'
+ vite: 7.0.6
resolution: {integrity: sha512-MHFiOENNBd+Bd9uvc8GEsIzdkn1JxMmEeYX35tI3fv0sJBUTfW5tQsoaOwuY4KhBI09A3dUJ/DXf2yxPVPUceg==}
@@ -17105,50 +16987,10 @@ packages:
yaml:
optional: true
- resolution: {integrity: sha512-w+N7Hifpc3gRjZ63vYBXA56dvvRlNWRczTdmCBBa+CotUzAPf5b7YMdMR/8CQoeYE5LX3W4wj6RYTgonm1b9DA==}
- engines: {node: ^20.19.0 || >=22.12.0}
- hasBin: true
- peerDependencies:
- '@types/node': ^20.19.0 || >=22.12.0
- jiti: '>=1.21.0'
- less: ^4.0.0
- lightningcss: ^1.21.0
- sass: ^1.70.0
- sass-embedded: ^1.70.0
- stylus: '>=0.54.8'
- sugarss: ^5.0.0
- terser: ^5.16.0
- tsx: ^4.8.1
- yaml: ^2.4.2
- peerDependenciesMeta:
- '@types/node':
- optional: true
- jiti:
- optional: true
- less:
- optional: true
- lightningcss:
- optional: true
- sass:
- optional: true
- sass-embedded:
- optional: true
- stylus:
- optional: true
- sugarss:
- optional: true
- terser:
- optional: true
- tsx:
- optional: true
- yaml:
- optional: true
-
resolution: {integrity: sha512-ub4okH7Z5KLjb6hDyjqrGXqWtWvoYdU3IGm/NorpgHncKoLTCfRIbvlhBm7r0YstIaQRYlp4yEbFqDcKSzXSSg==}
peerDependencies:
- vite: ^3.0.0 || ^4.0.0 || ^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0
+ vite: 7.0.6
peerDependenciesMeta:
vite:
optional: true
@@ -17962,12 +17804,12 @@ snapshots:
'@astrojs/internal-helpers': 0.8.0
'@types/react': 19.2.15
'@types/react-dom': 19.2.3(@types/[email protected])
devalue: 5.6.4
react: 19.2.6
react-dom: 19.2.6([email protected])
ultrahtml: 1.6.0
transitivePeerDependencies:
- '@types/node'
- jiti
@@ -24266,63 +24108,33 @@ snapshots:
optionalDependencies:
rollup: 4.60.1
- '@rollup/[email protected]':
- optional: true
-
'@rollup/[email protected]':
optional: true
- '@rollup/[email protected]':
- optional: true
-
'@rollup/[email protected]':
optional: true
- '@rollup/[email protected]':
- optional: true
-
'@rollup/[email protected]':
optional: true
- '@rollup/[email protected]':
- optional: true
-
'@rollup/[email protected]':
optional: true
- '@rollup/[email protected]':
- optional: true
-
'@rollup/[email protected]':
optional: true
- '@rollup/[email protected]':
- optional: true
-
'@rollup/[email protected]':
optional: true
- '@rollup/[email protected]':
- optional: true
-
'@rollup/[email protected]':
optional: true
- '@rollup/[email protected]':
- optional: true
-
'@rollup/[email protected]':
optional: true
- '@rollup/[email protected]':
- optional: true
-
'@rollup/[email protected]':
optional: true
- '@rollup/[email protected]':
- optional: true
-
'@rollup/[email protected]':
optional: true
@@ -24332,45 +24144,24 @@ snapshots:
'@rollup/[email protected]':
optional: true
- '@rollup/[email protected]':
- optional: true
-
- '@rollup/[email protected]':
- optional: true
-
'@rollup/[email protected]':
optional: true
'@rollup/[email protected]':
optional: true
- '@rollup/[email protected]':
- optional: true
-
'@rollup/[email protected]':
optional: true
- '@rollup/[email protected]':
- optional: true
-
'@rollup/[email protected]':
optional: true
- '@rollup/[email protected]':
- optional: true
-
'@rollup/[email protected]':
optional: true
- '@rollup/[email protected]':
- optional: true
-
'@rollup/[email protected]':
optional: true
- '@rollup/[email protected]':
- optional: true
-
'@rollup/[email protected]':
optional: true
@@ -24380,24 +24171,15 @@ snapshots:
'@rollup/[email protected]':
optional: true
- '@rollup/[email protected]':
- optional: true
-
'@rollup/[email protected]':
optional: true
- '@rollup/[email protected]':
- optional: true
-
'@rollup/[email protected]':
optional: true
'@rollup/[email protected]':
optional: true
- '@rollup/[email protected]':
- optional: true
-
'@rollup/[email protected]':
optional: true
@@ -25558,8 +25340,6 @@ snapshots:
dependencies:
'@types/estree': 1.0.8
- '@types/[email protected]': {}
-
'@types/[email protected]': {}
@@ -25840,7 +25620,7 @@ snapshots:
transitivePeerDependencies:
- '@swc/helpers'
dependencies:
'@babel/core': 7.29.0
'@babel/plugin-transform-react-jsx-self': 7.27.1(@babel/[email protected])
@@ -25848,7 +25628,7 @@ snapshots:
'@rolldown/pluginutils': 1.0.0-rc.3
'@types/babel__core': 7.20.5
react-refresh: 0.18.0
transitivePeerDependencies:
- supports-color
@@ -25864,7 +25644,7 @@ snapshots:
dependencies:
'@vitest/spy': 3.2.4
estree-walker: 3.0.3
- magic-string: 0.30.17
+ magic-string: 0.30.21
optionalDependencies:
@@ -25872,7 +25652,7 @@ snapshots:
dependencies:
'@vitest/spy': 3.2.4
estree-walker: 3.0.3
- magic-string: 0.30.17
+ magic-string: 0.30.21
optionalDependencies:
@@ -25889,7 +25669,7 @@ snapshots:
'@vitest/[email protected]':
dependencies:
'@vitest/pretty-format': 3.2.4
- magic-string: 0.30.17
+ magic-string: 0.30.21
pathe: 2.0.3
'@vitest/[email protected]':
@@ -26397,8 +26177,8 @@ snapshots:
unist-util-visit: 5.1.0
unstorage: 1.17.5([email protected])
vfile: 6.0.3
xxhash-wasm: 1.1.0
yargs-parser: 22.0.0
zod: 4.3.6
@@ -28968,10 +28748,6 @@ snapshots:
transitivePeerDependencies:
- encoding
- optionalDependencies:
- picomatch: 4.0.3
-
optionalDependencies:
picomatch: 4.0.3
@@ -35213,32 +34989,6 @@ snapshots:
optionalDependencies:
fsevents: 2.3.3
- dependencies:
- '@types/estree': 1.0.7
- optionalDependencies:
- '@rollup/rollup-android-arm-eabi': 4.42.0
- '@rollup/rollup-android-arm64': 4.42.0
- '@rollup/rollup-darwin-arm64': 4.42.0
- '@rollup/rollup-darwin-x64': 4.42.0
- '@rollup/rollup-freebsd-arm64': 4.42.0
- '@rollup/rollup-freebsd-x64': 4.42.0
- '@rollup/rollup-linux-arm-gnueabihf': 4.42.0
- '@rollup/rollup-linux-arm-musleabihf': 4.42.0
- '@rollup/rollup-linux-arm64-gnu': 4.42.0
- '@rollup/rollup-linux-arm64-musl': 4.42.0
- '@rollup/rollup-linux-loongarch64-gnu': 4.42.0
- '@rollup/rollup-linux-powerpc64le-gnu': 4.42.0
- '@rollup/rollup-linux-riscv64-gnu': 4.42.0
- '@rollup/rollup-linux-riscv64-musl': 4.42.0
- '@rollup/rollup-linux-s390x-gnu': 4.42.0
- '@rollup/rollup-linux-x64-gnu': 4.42.0
- '@rollup/rollup-linux-x64-musl': 4.42.0
- '@rollup/rollup-win32-arm64-msvc': 4.42.0
- '@rollup/rollup-win32-ia32-msvc': 4.42.0
- '@rollup/rollup-win32-x64-msvc': 4.42.0
- fsevents: 2.3.3
-
dependencies:
'@types/estree': 1.0.8
@@ -36386,7 +36136,7 @@ snapshots:
dependencies:
- fdir: 6.4.6([email protected])
+ fdir: 6.5.0([email protected])
picomatch: 4.0.3
@@ -37020,12 +36770,12 @@ snapshots:
- rollup
- supports-color
dependencies:
'@rollup/pluginutils': 5.1.4([email protected])
'@svgr/core': 8.1.0([email protected])
'@svgr/plugin-jsx': 8.1.0(@svgr/[email protected]([email protected]))
transitivePeerDependencies:
- rollup
- supports-color
@@ -37041,12 +36791,12 @@ snapshots:
- supports-color
- typescript
dependencies:
debug: 4.4.3
globrex: 0.1.2
tsconfck: 3.1.6([email protected])
transitivePeerDependencies:
- supports-color
- typescript
@@ -37054,11 +36804,11 @@ snapshots:
dependencies:
esbuild: 0.25.6
- fdir: 6.4.6([email protected])
+ fdir: 6.5.0([email protected])
picomatch: 4.0.3
postcss: 8.5.6
- rollup: 4.42.0
- tinyglobby: 0.2.14
+ rollup: 4.60.1
+ tinyglobby: 0.2.15
optionalDependencies:
'@types/node': 24.10.3
fsevents: 2.3.3
@@ -37072,24 +36822,6 @@ snapshots:
dependencies:
esbuild: 0.25.6
- fdir: 6.4.6([email protected])
- picomatch: 4.0.3
- postcss: 8.5.6
- rollup: 4.42.0
- tinyglobby: 0.2.14
- optionalDependencies:
- '@types/node': 24.10.3
- fsevents: 2.3.3
- jiti: 2.4.2
- lightningcss: 1.30.1
- sass: 1.89.1
- terser: 5.41.0
- tsx: 4.21.0
- yaml: 2.8.3
-
- dependencies:
- esbuild: 0.27.7
fdir: 6.5.0([email protected])
picomatch: 4.0.3
postcss: 8.5.6
@@ -37105,9 +36837,9 @@ snapshots:
tsx: 4.21.0
yaml: 2.8.3
optionalDependencies:
dependencies:
@@ -37120,15 +36852,15 @@ snapshots:
'@vitest/spy': 3.2.4
'@vitest/utils': 3.2.4
chai: 5.2.1
- debug: 4.4.1([email protected])
+ debug: 4.4.3
expect-type: 1.2.2
- magic-string: 0.30.17
+ magic-string: 0.30.21
pathe: 2.0.3
- picomatch: 4.0.2
+ picomatch: 4.0.3
std-env: 3.9.0
tinybench: 2.9.0
tinyexec: 0.3.2
- tinyglobby: 0.2.14
+ tinyglobby: 0.2.15
tinypool: 1.1.1
tinyrainbow: 2.0.0
@@ -37164,15 +36896,15 @@ snapshots:
'@vitest/spy': 3.2.4
'@vitest/utils': 3.2.4
chai: 5.2.1
- debug: 4.4.1([email protected])
+ debug: 4.4.3
expect-type: 1.2.2
- magic-string: 0.30.17
+ magic-string: 0.30.21
pathe: 2.0.3
- picomatch: 4.0.2
+ picomatch: 4.0.3
std-env: 3.9.0
tinybench: 2.9.0
tinyexec: 0.3.2
- tinyglobby: 0.2.14
+ tinyglobby: 0.2.15
tinypool: 1.1.1
tinyrainbow: 2.0.0
@@ -37197,6 +36929,50 @@ snapshots:
- tsx
- yaml
+ dependencies:
+ '@types/chai': 5.2.2
+ '@vitest/expect': 3.2.4
+ '@vitest/pretty-format': 3.2.4
+ '@vitest/runner': 3.2.4
+ '@vitest/snapshot': 3.2.4
+ '@vitest/spy': 3.2.4
+ '@vitest/utils': 3.2.4
+ chai: 5.2.1
+ debug: 4.4.3
+ expect-type: 1.2.2
+ magic-string: 0.30.21
+ pathe: 2.0.3
+ picomatch: 4.0.3
+ std-env: 3.9.0
+ tinybench: 2.9.0
+ tinyexec: 0.3.2
+ tinyglobby: 0.2.15
+ tinypool: 1.1.1
+ tinyrainbow: 2.0.0
+ why-is-node-running: 2.3.0
+ optionalDependencies:
+ '@types/debug': 4.1.12
+ '@types/node': 24.10.3
+ happy-dom: 20.3.9
+ jsdom: 27.4.0(@noble/[email protected])
+ transitivePeerDependencies:
+ - jiti
+ - less
+ - lightningcss
+ - msw
+ - sass
+ - sass-embedded
+ - stylus
+ - sugarss
+ - supports-color
+ - terser
+ - tsx
+ - yaml
+
dependencies:
'@types/chai': 5.2.2
@@ -37208,15 +36984,15 @@ snapshots:
'@vitest/spy': 3.2.4
'@vitest/utils': 3.2.4
chai: 5.2.1
- debug: 4.4.1([email protected])
+ debug: 4.4.3
expect-type: 1.2.2
- magic-string: 0.30.17
+ magic-string: 0.30.21
pathe: 2.0.3
- picomatch: 4.0.2
+ picomatch: 4.0.3
std-env: 3.9.0
tinybench: 2.9.0
tinyexec: 0.3.2
- tinyglobby: 0.2.14
+ tinyglobby: 0.2.15
tinypool: 1.1.1
tinyrainbow: 2.0.0
diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yaml
index 3a3d1648..e54f9a90 100644
--- a/pnpm-workspace.yaml
+++ b/pnpm-workspace.yaml
@@ -34,3 +34,11 @@ minimumReleaseAgeExclude:
- '@restatedev/[email protected]'
- '@restatedev/[email protected]'
- '@restatedev/[email protected]'
+
+# Pin vite so adding vitest as a direct devDep to apps/mcp doesn't hoist
+# vite 7.3.x, which surfaces a nested-vite peer mismatch inside
+# apps/browser-extension via @vitejs/plugin-react-swc. Both 7.0.6 and
+# 7.3.x were already in the lockfile before this PR; this just makes
+# 7.0.6 the workspace-wide resolution.
+overrides:
+ vite: 7.0.6