feat(lists): expose emoji + color in get_lists + create_list (v0.5.1)

get_lists now includes emoji and color fields per list entry.
create_list response also returns emoji and color from the API.

Field name verification (FW_DEBUG=1, 2026-04-16):
- emoji: API returns "" when unset -> normalised to null
- color: API omits key when unset -> normalised to null
- Both fields present in taskgettasklists and taskcreatelist responses

SPEC.md: taskgettasklists documented with full response structure
         and emoji/color normalisation notes.
         taskcreatelist response updated with emoji + color fields.

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

CLAUDE.md

@@ -37,8 +37,9 @@ und wird in Claude Desktop eingebunden.
 ## Roadmap
 
 - v0.4.x: Kategorie-Management, Task-Felder (due_date, assignee, list_id) ✓
-- v0.5.x: Listen-Management (create_list, delete_list) ← aktuell
+- v0.5.x: Listen-Management (create_list, delete_list) ✓
-- v0.5.1: update_list (Umbenennen), Sharing-Verwaltung
+- v0.5.1: emoji + color in get_lists / create_list ← aktuell
+- v0.5.2: update_list (Umbenennen, emoji/color ändern), Sharing-Verwaltung
 - v0.6.x: Erinnerungen + Wiederholungen (Premium-Account erforderlich)
 - v2.0: Schreibzugriff auf Wall-Posts (Erstellen, Kommentieren)
 

README.md

@@ -2,13 +2,13 @@
 
 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.16)
+## Features (v0.5.1)
 
 ### 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_lists` -- list all task lists (includes `emoji` and `color`; `null` when unset)
 - `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)
@@ -19,6 +19,8 @@ MCP server for [Family Wall](https://www.familywall.com) -- read and manage your
 - `update_task` -- update text, description, category, due date, assignees, or move to a different list; supports `clear_due_date=True` to remove a due date
 - `toggle_task` -- mark a task complete or reopen it
 - `delete_task` -- permanently delete a task
+- `create_list` -- create a new task list (SHOPPING_LIST or TODOS; optional `emoji` and `color`)
+- `delete_list` -- permanently delete a list and all its tasks (system lists are protected)
 - `create_category` -- create a custom category for a shopping list (with optional icon)
 - `delete_category` -- delete a custom category (system categories are protected)
 - `like_post` -- like a wall post/activity

SPEC.md

@@ -300,6 +300,8 @@ a00.r.r                     → vollständiges Listen-Objekt
   .name                     → Listen-Name
   .taskListType             → SHOPPING_LIST oder TODOS
   .sharedToAll              → "true" / "false"
+  .emoji                    → Unicode-Emoji (fehlt wenn nicht gesetzt)
+  .color                    → Hex-Farbwert z.B. "#E53935" (fehlt wenn nicht gesetzt)
   .rights.canDelete         → "true" (user-created lists)
 ```
 
@@ -325,10 +327,34 @@ MCP-Server prüft dies vor dem Löschen via `taskgettasklists`.
 
 **Verifiziert am:** 2026-04-16 via FW_DEBUG=1
 
-### `taskgettasklists` – Listen abrufen (alternativ)
+### `taskgettasklists` – Listen abrufen
 POST https://api.familywall.com/api/taskgettasklists
 
-Wird intern zur Verifikation von `taskListType` genutzt.
+**Body-Parameter:** keine
+
+**Response-Struktur:**
+```
+a00.r.r[]                   → Liste aller Task-Listen
+  .metaId                   → Listen-ID (z.B. "taskList/23431854_29740942")
+  .name                     → Systembezeichnung oder Benutzer-Name
+  .taskListType             → SHOPPING_LIST oder TODOS
+  .emoji                    → Unicode-Emoji oder "" (leerer String = kein Emoji)
+  .color                    → Hex-Farbwert z.B. "#E53935" (fehlt wenn nicht gesetzt)
+  .remainingTaskNumber      → offene Tasks (String)
+  .totalTaskNumber          → Gesamt-Tasks (String)
+  .sharedToAll              → "true" / "false"
+  .sharedMemberIds[]        → Member-accountIds
+  .rights.canDelete         → "true" = löschbar, fehlt/leer = Systemliste
+  .systemId                 → vorhanden nur bei Systemlisten (z.B. "-10", "-11")
+```
+
+**Hinweis emoji/color:**
+- `emoji`: Systemlisten liefern `""`, user-created Listen liefern den Emoji-String
+  oder `""` wenn kein Emoji gesetzt. Normalisierung: `""` → `null` im MCP-Server.
+- `color`: Fehlt komplett wenn nicht gesetzt (nicht `null` oder `""`).
+  Normalisierung: fehlendes Feld → `null` im MCP-Server.
+
+**Verifiziert am:** 2026-04-16 via FW_DEBUG=1
 
 ## Systembezeichnungen für Listen-Namen
 

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "mcp-familywall"
-version = "0.4.16"
+version = "0.5.1"
 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.16"
+__version__ = "0.5.1"

src/mcp_familywall/server.py

@@ -284,6 +284,9 @@ def get_lists(scope: str | None = None):
     result = []
     for item in raw_lists:
         # TODO: apply scope filtering once the circle field is identified.
+        # emoji: API returns "" when unset — normalise to None for a clean JSON null.
+        # color: API omits the key entirely when unset — .get() returns None directly.
+        raw_emoji: str = item.get("emoji", "")
         result.append(
             {
                 "id": item.get("metaId"),
@@ -291,6 +294,8 @@ def get_lists(scope: str | None = None):
                 "type": item.get("taskListType"),
                 "open": item.get("remainingTaskNumber"),
                 "total": item.get("totalTaskNumber"),
+                "emoji": raw_emoji if raw_emoji else None,
+                "color": item.get("color") or None,
             }
         )
 
@@ -927,6 +932,7 @@ def create_list(
             indent=2,
         )
 
+    raw_emoji: str = list_obj.get("emoji", "")
     return json.dumps(
         {
             "created": True,
@@ -934,6 +940,8 @@ def create_list(
             "name": list_obj.get("name", name),
             "type": list_obj.get("taskListType"),
             "shared_to_all": list_obj.get("sharedToAll") == "true",
+            "emoji": raw_emoji if raw_emoji else None,
+            "color": list_obj.get("color") or None,
         },
         ensure_ascii=False,
         indent=2,