feat: due_date, assignee_ids, list_id for create_task/update_task (v0.4.14)

- create_task: new optional params due_date (ISO 8601) and assignee_ids (list[str])
- update_task: new optional params due_date, assignee_ids, and list_id (move task)
- get_tasks: returns due_date and assignee_ids fields per task
- API params verified via FW_DEBUG=1: dueDate, assignee, taskListId
- SPEC.md, README, CLAUDE.md updated

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

CLAUDE.md

@@ -23,15 +23,15 @@ eingebunden.
 
 ## Aktueller Stand
 
-### Implementierte Tools (v0.4.11)
+### Implementierte Tools (v0.4.14)
 
 | Kategorie | Tools |
 |---|---|
 | Kreise | `get_circles`, `get_members` |
 | Listen | `get_lists` |
-| Tasks (Lesen) | `get_tasks` (inkl. `category_id`), `get_categories` (inkl. `custom`-Flag) |
+| Tasks (Lesen) | `get_tasks` (inkl. `category_id`, `due_date`, `assignee_ids`), `get_categories` (inkl. `custom`-Flag) |
 | Wall | `get_activities`, `like_post` |
-| Tasks (Schreiben) | `create_task` (inkl. `category_id`), `update_task` (inkl. `category_id`), `toggle_task`, `delete_task` |
+| Tasks (Schreiben) | `create_task` (inkl. `category_id`, `due_date`, `assignee_ids`), `update_task` (inkl. `category_id`, `due_date`, `assignee_ids`, `list_id`), `toggle_task`, `delete_task` |
 | Kategorien (Schreiben) | `create_category` (inkl. `icon`), `delete_category` (System-Kategorien geschützt) |
 
 

README.md

@@ -2,21 +2,21 @@
 
 MCP server for [Family Wall](https://www.familywall.com) -- read and manage your family's circles, lists, and tasks directly from Claude.
 
-## Features (v0.4.13)
+## Features (v0.4.14)
 
 ### Read
 
 - `get_circles` -- list all family circles
 - `get_members` -- list members of a circle (or all circles)
 - `get_lists` -- list all task lists (optionally filtered by circle)
-- `get_tasks` -- list tasks in a specific list (includes `category_id` field)
+- `get_tasks` -- list tasks in a specific list (includes `category_id`, `due_date`, `assignee_ids`)
 - `get_categories` -- list categories for a list (locale-filtered; custom categories always included; `custom` flag marks user-created ones)
 - `get_activities` -- list recent wall activities (author resolved to display name)
 
 ### Write (with confirmation prompt)
 
-- `create_task` -- create a new task in a list (supports `category_id` for shopping lists)
+- `create_task` -- create a new task in a list (supports `category_id`, `due_date`, `assignee_ids`)
-- `update_task` -- update text, description, and/or category of an existing task
+- `update_task` -- update text, description, category, due date, assignees, or move to a different list
 - `toggle_task` -- mark a task complete or reopen it
 - `delete_task` -- permanently delete a task
 - `create_category` -- create a custom category for a shopping list (with optional icon)

SPEC.md

@@ -168,8 +168,10 @@ a02.r.r.updatedCreated[]              → tasksync (Tasks)
     .name                             → Listen-Systemkategorien (z.B. "SYS-CAT-SHOPPINGLIST", "SYS-CAT-TODOS")
   .taskCategoryId                     → spezifische Task-Kategorie (verifiziert): metaId-Format
                                         (z.B. "taskCategory/23431854_200"), null wenn nicht gesetzt
-  .assignee / .assigneeIds            → zugewiesene Mitglieder
+  .assignee[]                         → zugewiesene Mitglieder: [{accountId: "..."}]
-  .reminder                           → Erinnerungsdatum (ISO 8601, optional)
+  .assigneeIds[]                      → zugewiesene Member-IDs als String-Array (z.B. ["23431898"])
+  .dueDate                            → Fälligkeitsdatum (ISO 8601, z.B. "2026-04-30T18:00:00.000Z"; null wenn nicht gesetzt)
+  .reminder                           → Erinnerungsregel (Objekt mit reminderUnit, reminderType, reminderValue — nicht das Fälligkeitsdatum!)
   .recurrency                         → Wiederholungsregel (optional)
   .sortingIndex                       → Anzeigereihenfolge
 ```
@@ -263,6 +265,8 @@ Content-Type: application/x-www-form-urlencoded
 | `text` | ja | Aufgabentitel |
 | `description` | nein | Optionale Beschreibung |
 | `taskCategoryId` | nein | Kategorie-MetaId aus `get_categories` (z.B. `taskCategory/23431854_200`) |
+| `dueDate` | nein | Fälligkeitsdatum ISO 8601 (z.B. `"2026-04-30T18:00:00"`); gespeichert als `dueDate` im Task-Objekt |
+| `assignee` | nein | Member-ID aus `get_members` (z.B. `"23431898"`); für mehrere Zuweisungen: mehrfach senden (`assignee=id1&assignee=id2`); gespeichert als `assigneeIds[]` im Task-Objekt |
 
 **Response-Struktur (verifiziert):**
 ```
@@ -285,8 +289,11 @@ Content-Type: application/x-www-form-urlencoded
 | `text` | nein | Neuer Titel (mindestens eines der optionalen Felder erforderlich) |
 | `description` | nein | Neue Beschreibung |
 | `taskCategoryId` | nein | Kategorie-MetaId aus `get_categories` (z.B. `taskCategory/23431854_200`) |
+| `dueDate` | nein | Fälligkeitsdatum ISO 8601 (z.B. `"2026-04-30T18:00:00"`); gespeichert als `dueDate` im Task-Objekt |
+| `assignee` | nein | Member-ID aus `get_members` (z.B. `"23431898"`); für mehrere Zuweisungen: mehrfach senden (`assignee=id1&assignee=id2`); leerer String (`""`) entfernt alle Zuweisungen (nicht verifiziert); gespeichert als `assigneeIds[]` im Task-Objekt |
+| `taskListId` | nein | Ziel-Listen-ID zum Verschieben des Tasks (verifiziert – ändert `taskListId` im Task-Objekt) |
 
-Hinweis: `taskListId` ist **nicht** erforderlich (verifiziert – Update ohne `taskListId` funktioniert).
+Hinweis: `taskListId` ist optional – ohne diesen Parameter bleibt der Task in seiner aktuellen Liste.
 
 **Response-Struktur:** kein spezifischer Rückgabewert – Erfolg = kein `ex`/`un`-Key auf Top-Level.
 
@@ -491,3 +498,7 @@ AND `moodStarShortcut: false` AND `moodMap: {}`.
 - ~~`taskcreate2` / `taskupdate2`: Kategorie-Paramter-Name~~ → **`taskCategoryId`**, Wert = vollständige metaId (verifiziert)
 - ~~`taskcategoryput`: Body-Parameter, Response-Struktur~~ → `name` (Pflicht), `emoji` (optional), Response = neues Kategorie-Objekt (verifiziert)
 - ~~`taskcategorydelete`: Body-Parameter~~ → **`id`** (nicht `metaId`!), Response = `"true"` (verifiziert)
+- ~~`taskcreate2` / `taskupdate2`: Fälligkeitsdatum-Parameter~~ → **`dueDate`**, ISO 8601 String, gespeichert als `dueDate` im Task-Objekt (verifiziert)
+- ~~`taskcreate2` / `taskupdate2`: Zuweisung-Parameter~~ → **`assignee`** (Member-ID String; mehrere Werte = mehrfach senden); gespeichert als `assigneeIds[]` (verifiziert)
+- ~~`taskupdate2`: Task verschieben~~ → **`taskListId`** als optionaler Parameter setzt neue Liste (verifiziert)
+- `taskupdate2`: Alle Zuweisungen entfernen (leere `assignee`-Liste) → noch nicht verifiziert

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "mcp-familywall"
-version = "0.4.13"
+version = "0.4.14"
 description = "MCP server for Family Wall — read your family's lists and tasks via Claude"
 readme = "README.md"
 requires-python = ">=3.12"

src/mcp_familywall/__init__.py

@@ -1 +1 @@
-__version__ = "0.4.13"
+__version__ = "0.4.14"

src/mcp_familywall/server.py

@@ -326,6 +326,8 @@ def get_tasks(list_id: str, only_open: bool = True):
                 "description": task.get("description"),
                 "completed": completed,
                 "category_id": task.get("taskCategoryId"),
+                "due_date": task.get("dueDate"),
+                "assignee_ids": task.get("assigneeIds") or [],
             }
         )
 
@@ -676,6 +678,8 @@ def create_task(
     text: str,
     description: str | None = None,
     category_id: str | None = None,
+    due_date: str | None = None,
+    assignee_ids: list[str] | None = None,
 ) -> str:
     """Create a new task in the given list.
 
@@ -688,6 +692,9 @@ def create_task(
         category_id: Optional category metaId from get_categories
             (e.g. ``taskCategory/23431854_200``). Only meaningful for
             shopping lists; ignored for TODO lists.
+        due_date: Optional due date in ISO 8601 format (e.g. ``"2026-04-30T18:00:00"``).
+        assignee_ids: Optional list of member IDs from get_members to assign the task
+            (e.g. ``["23431898"]``). Empty list assigns to nobody.
 
     Returns:
         JSON with the new task's metaId on success, or an error message.
@@ -697,6 +704,10 @@ def create_task(
         params["description"] = description
     if category_id:
         params["taskCategoryId"] = category_id
+    if due_date is not None:
+        params["dueDate"] = due_date
+    if assignee_ids is not None:
+        params["assignee"] = assignee_ids if assignee_ids else ""
 
     try:
         data = _authenticated_call("taskcreate2", params)
@@ -728,11 +739,14 @@ def update_task(
     text: str | None = None,
     description: str | None = None,
     category_id: str | None = None,
+    due_date: str | None = None,
+    assignee_ids: list[str] | None = None,
+    list_id: str | None = None,
 ) -> str:
-    """Update the text, description, and/or category of an existing task.
+    """Update an existing task's fields.
 
     IMPORTANT: Ask the user for confirmation before calling this tool.
-    At least one of *text*, *description*, or *category_id* must be provided.
+    At least one parameter besides *task_id* must be provided.
 
     Args:
         task_id: Task metaId from get_tasks.
@@ -741,12 +755,26 @@ def update_task(
         category_id: New category metaId from get_categories
             (e.g. ``taskCategory/23431854_200``). Only meaningful for
             shopping lists; ignored for TODO lists.
+        due_date: New due date in ISO 8601 format (e.g. ``"2026-04-30T18:00:00"``).
+            Omit to leave unchanged.
+        assignee_ids: New list of member IDs from get_members (e.g. ``["23431898"]``).
+            Pass an empty list to remove all assignees. Omit to leave unchanged.
+        list_id: Move the task to a different list by providing the target list ID
+            from get_lists (e.g. ``"taskList/23431854_29740942"``). Omit to keep in
+            current list.
 
     Returns:
         JSON success indicator or an error message.
     """
-    if text is None and description is None and category_id is None:
+    if (
-        return "Error: At least one of 'text', 'description', or 'category_id' must be provided."
+        text is None
+        and description is None
+        and category_id is None
+        and due_date is None
+        and assignee_ids is None
+        and list_id is None
+    ):
+        return "Error: At least one of 'text', 'description', 'category_id', 'due_date', 'assignee_ids', or 'list_id' must be provided."
 
     params: dict[str, Any] = {"metaId": task_id}
     if text is not None:
@@ -755,6 +783,12 @@ def update_task(
         params["description"] = description
     if category_id is not None:
         params["taskCategoryId"] = category_id
+    if due_date is not None:
+        params["dueDate"] = due_date
+    if assignee_ids is not None:
+        params["assignee"] = assignee_ids if assignee_ids else ""
+    if list_id is not None:
+        params["taskListId"] = list_id
 
     try:
         _authenticated_call("taskupdate2", params)