Files

T

marcus 0d8036fd4a fix: get_categories always includes custom categories (v0.4.12)

Custom categories (rights.canDelete=true) have no locale field set by
the API and were silently excluded by the locale filter. They now bypass
both the locale and taskListType filters so they always appear in
get_categories output regardless of the locale parameter.

Also: deleted 7 test categories (TEmojiApple, Obst & Gemüse (old),
TestKategorie, ProbeKat2, [TEST]emoji=apple, ProbeKat1, TDelMeta)
and restored 'Obst & Gemüse' (emoji 🍎) as a clean custom category.

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

2026-04-16 08:06:21 +02:00

2.2 KiB

Raw Blame History

mcp-familywall

MCP server for Family Wall -- read and manage your family's circles, lists, and tasks directly from Claude.

Features (v0.4.12)

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_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)
update_task -- update text, description, and/or category of an existing task
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)
delete_category -- delete a custom category (system categories are protected)
like_post -- like a wall post/activity

Requirements

Python 3.12+
uv
A Family Wall account

Installation

uv tool install mcp-familywall

Setup

Run the interactive setup wizard once to store your credentials securely in the OS keyring:

mcp-familywall setup

This will:

Prompt for your Family Wall email and password
Verify the credentials against the API
Store them in the OS keyring
Print a Claude Desktop configuration snippet

Claude Desktop configuration

Add the printed snippet to your claude_desktop_config.json:

{
  "mcpServers": {
    "familywall": {
      "command": "uvx",
      "args": ["mcp-familywall", "serve"]
    }
  }
}

Verify

mcp-familywall check

Debug logging

Set FW_DEBUG=1 to log full request/response bodies to stderr (passwords are masked):

FW_DEBUG=1 mcp-familywall check

Credentials

Credentials are resolved in this order:

Environment variables FW_EMAIL and FW_PASSWORD
OS keyring (set by mcp-familywall setup)

License

MIT

2.2 KiB Raw Blame History