Files

T

marcus 5698196c43 feat: create_category + delete_category tools (v0.4.11)

Verified via systematic FW_DEBUG=1 probing:
- taskcategoryput: requires 'name'; optional 'emoji' (Unicode or string code)
  accepted as-is. 'listId' param has no per-list effect — categories are
  family-wide.
- taskcategorydelete: uses 'id' param (not 'metaId'), returns r='true'.

Changes:
- create_category(list_id, name, icon=None): creates custom category via
  taskcategoryput; icon maps to 'emoji' API param
- delete_category(category_id): safety check via accgetallfamily looks up
  rights.canDelete='true'; system categories (rights.canDelete=null) are
  refused with a clear error
- get_categories: now exposes 'custom' bool field (rights.canDelete='true')
  so callers can identify deletable categories
- SPEC.md: document taskcategoryput + taskcategorydelete params, responses,
  error formats, and system-category protection behaviour

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

2026-04-16 07:43:54 +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.11)

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 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