# mcp-familywall

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

### 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
- `get_activities` -- list recent wall activities

### Write (with confirmation prompt)

- `create_task` -- create a new task in a list
- `update_task` -- update the text/description of an existing task
- `toggle_task` -- mark a task complete or reopen it
- `delete_task` -- permanently delete a task
- `like_post` -- like or unlike a wall post/activity

## Requirements

- Python 3.12+
- [uv](https://docs.astral.sh/uv/)
- A Family Wall account

## Installation

```bash
uv tool install mcp-familywall
```

## Setup

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

```bash
mcp-familywall setup
```

This will:
1. Prompt for your Family Wall email and password
2. Verify the credentials against the API
3. Store them in the OS keyring
4. Print a Claude Desktop configuration snippet

## Claude Desktop configuration

Add the printed snippet to your `claude_desktop_config.json`:

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

## Verify

```bash
mcp-familywall check
```

## Debug logging

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

```bash
FW_DEBUG=1 mcp-familywall check
```

## Credentials

Credentials are resolved in this order:

1. Environment variables `FW_EMAIL` and `FW_PASSWORD`
2. OS keyring (set by `mcp-familywall setup`)

## License

MIT