@fswap/mcp-vikunja 0.1.1 → 0.1.3

package/README.md

@@ -88,7 +88,7 @@ VIKUNJA_API_TOKEN = "tk_..."
 | `list_projects` | `GET /projects` | id, title, description, parent |
 | `get_project` | `GET /projects/{id}` | |
 | `create_project` | `PUT /projects` | optional parent project |
-| `list_tasks` | `GET /tasks/all` or `GET /projects/{id}/tasks` | open tasks by default; `filter`, `sortBy`, pagination |
+| `list_tasks` | `GET /tasks` or `GET /projects/{id}/tasks` | open tasks by default; `assignedToMe`, `filter`, `sortBy`, pagination |
 | `get_task` | `GET /tasks/{id}` | full task incl. description, labels, assignees |
 | `create_task` | `PUT /projects/{id}/tasks` | title, description, dates, priority, labels |
 | `update_task` | `POST /tasks/{id}` | merges your changes onto the current task; `labelIds` replaces labels |
@@ -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,27 +241,40 @@ 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,
 		projectId: t.project_id,
 		identifier: t.identifier || null,
 		labels: (t.labels ?? []).map((l) => l.title),
+		assignees: (t.assignees ?? []).map((u) => u.username),
 		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),
@@ -277,10 +303,11 @@ 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 and label names (no descriptions — use get_task). By default only open tasks are returned. For advanced queries pass a raw Vikunja `filter` string such as `done = false && due_date < now+7d` or `labels in 3, 5`.",
+		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"),
+			assignedToMe: z.boolean().default(false).describe("Only tasks assigned to the authenticated user"),
 			search: z.string().optional().describe("Full-text search in title/description"),
 			filter: z.string().optional().describe("Raw Vikunja filter expression; overrides includeDone. Fields: done, due_date, priority, labels, assignees, project"),
 			sortBy: z.enum([
@@ -296,24 +323,33 @@ function registerTaskTools(server, vikunja, { allowDelete = false, defaultProjec
 			page: z.number().int().min(1).default(1),
 			perPage: z.number().int().min(1).max(100).default(50)
 		}
-	}, guard(async ({ projectId, includeDone, search, filter, sortBy, orderBy, page, perPage }) => {
-		const effectiveFilter = filter ?? (includeDone ? void 0 : "done = false");
-		const path = projectId != null ? `/projects/${projectId}/tasks` : "/tasks/all";
-		return ok((await vikunja.get(path, {
+	}, guard(async ({ projectId, includeDone, assignedToMe, search, filter, sortBy, orderBy, page, perPage }) => {
+		const clauses = [];
+		if (filter) clauses.push(`(${filter})`);
+		else if (!includeDone) clauses.push("done = false");
+		if (assignedToMe) {
+			const me = await vikunja.get("/user");
+			clauses.push(`assignees in '${me.username}'`);
+		}
+		const effectiveFilter = clauses.length > 0 ? clauses.join(" && ") : void 0;
+		const path = projectId != null ? `/projects/${projectId}/tasks` : "/tasks";
+		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",
@@ -342,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",
@@ -383,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",
@@ -397,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.1",
+  "version": "0.1.3",
   "description": "MCP server for Vikunja — list, create, update and complete tasks from Claude",
   "type": "module",
   "bin": {