Files

T

marcus 38da31b0cb feat: Gruppe 1 – Projektgerüst, Auth, CLI (v0.1.0)

- pyproject.toml: hatchling build, mcp-familywall entry-point, deps
- src/mcp_familywall/__init__.py: version 0.1.0
- src/mcp_familywall/config.py: YAML config loader (schema_version: 1)
- src/mcp_familywall/auth.py: keyring credential resolution (FW_EMAIL/FW_PASSWORD → keyring)
- src/mcp_familywall/fw_client.py: httpx client, login/logout/call, FW_DEBUG logging
- src/mcp_familywall/cli.py: click CLI with setup / check / serve commands
- .gitignore, README.md, CLAUDE.md, SPEC.md

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

2026-04-15 12:18:37 +02:00

1.4 KiB

Raw Blame History

mcp-familywall

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

Features (v1.0 -- read-only)

get_circles -- list all family circles
get_lists -- list all task lists (optionally filtered by circle)
get_tasks -- list tasks in a specific list

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

1.4 KiB Raw Blame History