@fswap/mcp-vikunja 0.1.2 → 0.1.3

package/README.md

@@ -97,7 +97,7 @@ VIKUNJA_API_TOKEN = "tk_..."
 | `create_label` | `PUT /labels` | |
 | `delete_task` | `DELETE /tasks/{id}` | only when delete is allowed (setup answer or `VIKUNJA_ALLOW_DELETE=true`) |
 
-Vikunja's zero date (`0001-01-01T00:00:00Z`) is normalised to `null` in every response. API errors are returned to the model as `isError` results rather than crashing the server.
+Every task and project includes a `url` to its page in the Vikunja web UI (taken from `/info` `frontend_url`). Vikunja's zero date (`0001-01-01T00:00:00Z`) is normalised to `null` in every response. API errors are returned to the model as `isError` results rather than crashing the server.
 
 ## Development
 

package/dist/index.js

@@ -180,10 +180,11 @@ function stripUndefined(obj) {
 }
 //#endregion
 //#region src/tools/projects.ts
-function summarizeProject(p) {
+function summarizeProject(p, base) {
 	return {
 		id: p.id,
 		title: p.title,
+		url: `${base}/projects/${p.id}`,
 		description: p.description || null,
 		identifier: p.identifier || null,
 		parentProjectId: p.parent_project_id || null,
@@ -191,6 +192,16 @@ function summarizeProject(p) {
 		favorite: Boolean(p.is_favorite)
 	};
 }
+let frontendBase$1 = null;
+async function frontendUrl$1(vikunja) {
+	if (frontendBase$1) return frontendBase$1;
+	try {
+		frontendBase$1 = ((await vikunja.get("/info")).frontend_url || vikunja.baseUrl).replace(/\/+$/, "");
+	} catch {
+		frontendBase$1 = vikunja.baseUrl;
+	}
+	return frontendBase$1;
+}
 function registerProjectTools(server, vikunja) {
 	server.registerTool("list_projects", {
 		title: "List projects",
@@ -202,19 +213,21 @@ function registerProjectTools(server, vikunja) {
 			perPage: z.number().int().min(1).max(100).default(50)
 		}
 	}, guard(async ({ search, includeArchived, page, perPage }) => {
-		return ok((await vikunja.get("/projects", {
+		const data = await vikunja.get("/projects", {
 			s: search,
 			is_archived: includeArchived ? true : void 0,
 			page,
 			per_page: perPage
-		})).map(summarizeProject));
+		});
+		const base = await frontendUrl$1(vikunja);
+		return ok(data.map((p) => summarizeProject(p, base)));
 	}));
 	server.registerTool("get_project", {
 		title: "Get project",
 		description: "Get one Vikunja project by id.",
 		inputSchema: { id: z.number().int().describe("Project id") }
 	}, guard(async ({ id }) => {
-		return ok(summarizeProject(await vikunja.get(`/projects/${id}`)));
+		return ok(summarizeProject(await vikunja.get(`/projects/${id}`), await frontendUrl$1(vikunja)));
 	}));
 	server.registerTool("create_project", {
 		title: "Create project",
@@ -228,15 +241,27 @@ function registerProjectTools(server, vikunja) {
 		const body = { title };
 		if (description !== void 0) body.description = description;
 		if (parentProjectId !== void 0) body.parent_project_id = parentProjectId;
-		return ok(summarizeProject(await vikunja.put("/projects", body)));
+		return ok(summarizeProject(await vikunja.put("/projects", body), await frontendUrl$1(vikunja)));
 	}));
 }
 //#endregion
 //#region src/tools/tasks.ts
-function summarizeTask(t) {
+let frontendBase = null;
+/** Resolve the web UI base URL once (Vikunja's API host may differ from its frontend host). */
+async function frontendUrl(vikunja) {
+	if (frontendBase) return frontendBase;
+	try {
+		frontendBase = ((await vikunja.get("/info")).frontend_url || vikunja.baseUrl).replace(/\/+$/, "");
+	} catch {
+		frontendBase = vikunja.baseUrl;
+	}
+	return frontendBase;
+}
+function summarizeTask(t, base) {
 	return {
 		id: t.id,
 		title: t.title,
+		url: `${base}/tasks/${t.id}`,
 		done: t.done,
 		dueDate: normalizeDate(t.due_date),
 		priority: t.priority ?? 0,
@@ -247,9 +272,9 @@ function summarizeTask(t) {
 		updated: t.updated
 	};
 }
-function fullTask(t) {
+function fullTask(t, base) {
 	return {
-		...summarizeTask(t),
+		...summarizeTask(t, base),
 		description: t.description || "",
 		doneAt: normalizeDate(t.done_at),
 		startDate: normalizeDate(t.start_date),
@@ -278,7 +303,7 @@ async function setLabels(vikunja, taskId, labelIds) {
 function registerTaskTools(server, vikunja, { allowDelete = false, defaultProjectId = null } = {}) {
 	server.registerTool("list_tasks", {
 		title: "List tasks",
-		description: "List tasks, across all projects or within one project. Returns id, title, done, due date, priority, label names and assignee usernames (no descriptions — use get_task). By default only open tasks are returned. Set assignedToMe=true for the current user's tasks. For advanced queries pass a raw Vikunja `filter` string such as `done = false && due_date < now+7d`, `labels in 3, 5` or `assignees in alice`.",
+		description: "List tasks, across all projects or within one project. Returns id, title, done, due date, priority, label names, assignee usernames and a web url (no descriptions — use get_task). By default only open tasks are returned. Set assignedToMe=true for the current user's tasks. For advanced queries pass a raw Vikunja `filter` string such as `done = false && due_date < now+7d`, `labels in 3, 5` or `assignees in alice`.",
 		inputSchema: {
 			projectId: z.number().int().optional().describe("Limit to this project (omit for all projects)"),
 			includeDone: z.boolean().default(false).describe("Include completed tasks"),
@@ -308,21 +333,23 @@ function registerTaskTools(server, vikunja, { allowDelete = false, defaultProjec
 		}
 		const effectiveFilter = clauses.length > 0 ? clauses.join(" && ") : void 0;
 		const path = projectId != null ? `/projects/${projectId}/tasks` : "/tasks";
-		return ok((await vikunja.get(path, {
+		const data = await vikunja.get(path, {
 			s: search,
 			filter: effectiveFilter,
 			sort_by: sortBy,
 			order_by: orderBy,
 			page,
 			per_page: perPage
-		})).map(summarizeTask));
+		});
+		const base = await frontendUrl(vikunja);
+		return ok(data.map((t) => summarizeTask(t, base)));
 	}));
 	server.registerTool("get_task", {
 		title: "Get task",
 		description: "Get a single task with full details: description, dates, priority, labels and assignees.",
 		inputSchema: { id: z.number().int().describe("Task id") }
 	}, guard(async ({ id }) => {
-		return ok(fullTask(await vikunja.get(`/tasks/${id}`)));
+		return ok(fullTask(await vikunja.get(`/tasks/${id}`), await frontendUrl(vikunja)));
 	}));
 	server.registerTool("create_task", {
 		title: "Create task",
@@ -351,7 +378,7 @@ function registerTaskTools(server, vikunja, { allowDelete = false, defaultProjec
 			await setLabels(vikunja, task.id, labelIds);
 			task = await vikunja.get(`/tasks/${task.id}`);
 		}
-		return ok(fullTask(task));
+		return ok(fullTask(task, await frontendUrl(vikunja)));
 	}));
 	server.registerTool("update_task", {
 		title: "Update task",
@@ -392,7 +419,7 @@ function registerTaskTools(server, vikunja, { allowDelete = false, defaultProjec
 			await setLabels(vikunja, id, labelIds);
 			task = await vikunja.get(`/tasks/${id}`);
 		}
-		return ok(fullTask(task));
+		return ok(fullTask(task, await frontendUrl(vikunja)));
 	}));
 	server.registerTool("complete_task", {
 		title: "Complete task",
@@ -406,7 +433,7 @@ function registerTaskTools(server, vikunja, { allowDelete = false, defaultProjec
 		return ok(summarizeTask(await vikunja.post(`/tasks/${id}`, {
 			...current,
 			done
-		})));
+		}), await frontendUrl(vikunja)));
 	}));
 	server.registerTool("list_labels", {
 		title: "List labels",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fswap/mcp-vikunja",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "MCP server for Vikunja — list, create, update and complete tasks from Claude",
   "type": "module",
   "bin": {