@fswap/mcp-vikunja 0.1.0 → 0.1.2

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 |

package/dist/index.js

@@ -243,6 +243,7 @@ function summarizeTask(t) {
 		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
 	};
 }
@@ -277,10 +278,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 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`.",
 		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,9 +298,16 @@ 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";
+	}, 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";
 		return ok((await vikunja.get(path, {
 			s: search,
 			filter: effectiveFilter,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fswap/mcp-vikunja",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "MCP server for Vikunja — list, create, update and complete tasks from Claude",
   "type": "module",
   "bin": {
@@ -10,7 +10,7 @@
     "dist"
   ],
   "engines": {
-    "node": ">=18"
+    "node": ">=20.12.0"
   },
   "scripts": {
     "build": "tsdown",