Familia
by familiaplanner.com · remote · no sign-in to list tools · v0.9.0 · published by com.familiaplanner
Private family planner for schedules, tasks, checklists, attachments, and availability.
25 tools: 12 can delete or cancel things, 1 change things and 12 only read.
Scanned Oct 21, 2026
- Deletes or cancels12Claude Code: deny: see these tools
- Can't be undone0Claude Code: ask
- Changes things1Claude Code: ask: see these tools
- Only reads12Claude Code: allow: see these tools
3 checks matched something in the tool definitions. No finding is not a safety guarantee. How the checks work.
claude mcp add --transport http familia https://mcp.family.asynq.org/mcp --header 'Authorization: <your-authorization>'Findings
Matches of fixed checks, with the text they matched.
The input schema at properties.operations.items.anyOf[1].properties.items.items.$ref contains a 79-character base64 string.
What this check looks forMatched text
inputSchema.properties.operations.items.anyOf[1].properties.items.items.$ref: "#/properties/operations/items/anyOf/0/properties/todoList/properties/..."
The input schema at properties.operations.items.anyOf[1].properties.idempotencyKey.$ref contains a 62-character base64 string.
What this check looks forMatched text
inputSchema.properties.operations.items.anyOf[1].properties.idempotencyKey.$ref: "#/properties/operations/items/anyOf/0/properties/idempotencyKey"
The input schema at properties.operations.items.anyOf[2].properties.relatedTasks.items.properties.idempotencyKey.$ref contains a 62-character base64 string.
What this check looks forMatched text
inputSchema.properties.operations.items.anyOf[2].properties.relatedTasks.items.properties.idempotencyKey.$ref: "#/properties/operations/items/anyOf/0/properties/idempotencyKey"
Tools
Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.
25 tools
Deletes or cancels 12Claude Code: deny
familia_attach_imageUse this when the user asks to attach a JPEG, PNG, or WebP image to an existing Familia task or plan.No findings
Why it is in this group
- The name "familia_attach_image" says "attach": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it Use this when the user asks to attach a JPEG, PNG, or WebP image to an existing Familia task or plan. Provide either dataUrl or base64Data plus mimeType. Do not use for non-image files.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: true
- openWorldHint: false
familia_batch_writeUse this when the user explicitly asks to create or modify multiple Familia tasks, list tasks, plans, or task attachments in one request, or when one prompt contains multiple stand…3 findings
Why it is in this group
- The name "familia_batch_write" says "write": a word for a change.
- The server marks it destructive (destructiveHint: true).
Findings
- Warn
The input schema at properties.operations.items.anyOf[1].properties.items.items.$ref contains a 79-character base64 string.
What this check looks forMatched text
inputSchema.properties.operations.items.anyOf[1].properties.items.items.$ref: "#/properties/operations/items/anyOf/0/properties/todoList/properties/..."
- Warn
The input schema at properties.operations.items.anyOf[1].properties.idempotencyKey.$ref contains a 62-character base64 string.
What this check looks forMatched text
inputSchema.properties.operations.items.anyOf[1].properties.idempotencyKey.$ref: "#/properties/operations/items/anyOf/0/properties/idempotencyKey"
- Warn
The input schema at properties.operations.items.anyOf[2].properties.relatedTasks.items.properties.idempotencyKey.$ref contains a 62-character base64 string.
What this check looks forMatched text
inputSchema.properties.operations.items.anyOf[2].properties.relatedTasks.items.properties.idempotencyKey.$ref: "#/properties/operations/items/anyOf/0/properties/idempotencyKey"
Description, as the server wrote it Use this when the user explicitly asks to create or modify multiple Familia tasks, list tasks, plans, or task attachments in one request, or when one prompt contains multiple standalone dated actions that should become separate tasks. When the same task or plan repeats, use repeatRule/rrule on one operation instead of creating duplicate one-time operations. For a main event/trip plus clearly related dated actions, prefer one create_plan operation with relatedTasks. Internally this runs bounded individual write operations one by one; it does not create a backend transaction. Operations can queue assignment notifications and reminders; delivered notifications cannot be recalled.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: true
- openWorldHint: false
familia_cancel_taskUse this only when the user explicitly asks to cancel, archive, or hide an existing Familia task without permanently deleting the record.No findings
Why it is in this group
- The name "familia_cancel_task" says "cancel": a word for removing or ending something.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it Use this only when the user explicitly asks to cancel, archive, or hide an existing Familia task without permanently deleting the record. Do not use to mark a task done; use familia_update_task instead.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: true
- openWorldHint: false
familia_create_list_taskUse this when the user asks to create a shopping list, packing list, checklist, or Familia task with list items.No findings
Why it is in this group
- The name "familia_create_list_task" says "create": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it Use this when the user asks to create a shopping list, packing list, checklist, or Familia task with list items. If the same list task repeats across several days, weeks, or months, provide repeatRule and create one recurring list task instead of multiple one-time tasks. Do not use when editing an existing list attachment. Assigning to another household member queues a push notification; schedules can also queue reminders, and delivered notifications cannot be recalled.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: true
- openWorldHint: false
familia_create_planUse this when the user asks to create a Familia plan item for an event, trip, holiday, school, activity, care coverage, travel, chore block, or other scheduled family plan.No findings
Why it is in this group
- The name "familia_create_plan" says "create": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it Use this when the user asks to create a Familia plan item for an event, trip, holiday, school, activity, care coverage, travel, chore block, or other scheduled family plan. If the same plan repeats across several days, weeks, or months, provide rrule and create one recurring plan instead of multiple one-time plans. If the user gives multiple dated or timed actions that clearly belong to the plan, such as flights, leaving for the airport, pickup, packing, check-in, or return travel, put the main event/trip in the plan and create each dated action as a relatedTasks entry instead of stuffing them all into notes. Do not use for standalone responsibility-style task reminders; use familia_create_task or familia_batch_write instead. Related tasks assigned to another household member can queue push notifications; schedules can trigger reminders, and delivered notifications cannot be recalled.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: true
- openWorldHint: false
familia_create_taskUse this when the user asks to create a responsibility-style Familia task, agreement, reminder, or chore.No findings
Why it is in this group
- The name "familia_create_task" says "create": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it Use this when the user asks to create a responsibility-style Familia task, agreement, reminder, or chore. If the same task repeats across several days, weeks, or months, provide repeatRule and create one recurring task instead of multiple one-time tasks. Do not use for calendar-style events, trips, school activities, or holidays; use familia_create_plan instead. When the primary intent is a shopping list, packing list, or standalone checklist, use familia_create_list_task. Assigning to another household member queues a push notification; schedules can also queue reminders, and delivered notifications cannot be recalled.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: true
- openWorldHint: false
familia_delete_attachmentUse this only when the user explicitly asks to delete or remove an existing Familia photo, checklist, or list attachment.No findings
Why it is in this group
- The name "familia_delete_attachment" says "delete": a word for removing or ending something.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it Use this only when the user explicitly asks to delete or remove an existing Familia photo, checklist, or list attachment. Do not use for hiding or summarizing attachments.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: true
- openWorldHint: false
familia_delete_planUse this only when the user explicitly asks to delete, remove, or cancel an existing Familia plan item.No findings
Why it is in this group
- The name "familia_delete_plan" says "delete": a word for removing or ending something.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it Use this only when the user explicitly asks to delete, remove, or cancel an existing Familia plan item. Do not use to reschedule or complete a plan; use familia_update_plan instead. Cancelling a shared plan can update existing guest copies and queue cancellation notifications; delivered notifications cannot be recalled.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: true
- openWorldHint: false
familia_delete_taskUse this only when the user explicitly asks to permanently delete or hard delete an existing Familia task.No findings
Why it is in this group
- The name "familia_delete_task" says "delete": a word for removing or ending something.
- The description says "permanently delete".
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it Use this only when the user explicitly asks to permanently delete or hard delete an existing Familia task. This removes the record and related task schedules, occurrences, reminders, and attachments.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: true
- openWorldHint: false
familia_update_list_attachmentUse this when the user asks to edit, add, remove, reorder, or mark items in an existing Familia checklist/list attachment.No findings
Why it is in this group
- The name "familia_update_list_attachment" says "update": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it Use this when the user asks to edit, add, remove, reorder, or mark items in an existing Familia checklist/list attachment. This replaces the existing list content; list attachments first if the attachment id is unknown.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: true
- openWorldHint: false
familia_update_planUse this when the user asks to rename, reschedule, move, update location, link tasks, change participants, or otherwise edit an existing Familia plan.No findings
Why it is in this group
- The name "familia_update_plan" says "update": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it Use this when the user asks to rename, reschedule, move, update location, link tasks, change participants, or otherwise edit an existing Familia plan. Do not use to create a new plan. Updates can synchronize copies already imported by invited guests and queue notifications; delivered notifications cannot be recalled.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: true
- openWorldHint: false
familia_update_taskUse this when the user asks to rename, reschedule, reassign, complete, cancel, or otherwise edit an existing Familia task.No findings
Why it is in this group
- The name "familia_update_task" says "update": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it Use this when the user asks to rename, reschedule, reassign, complete, cancel, or otherwise edit an existing Familia task. When status is done, this completes the next actionable occurrence so recurring tasks continue. Do not use to create a new task. Updates may notify household members and reschedule reminders; delivered notifications cannot be recalled.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: true
- openWorldHint: false
Changes things 1Claude Code: ask
familia_create_list_attachmentUse this when the user asks to add a new checklist, shopping list, packing list, or structured subtasks to an existing Familia task or plan.No findings
Why it is in this group
- The name "familia_create_list_attachment" says "create": a word for a change.
Description, as the server wrote it Use this when the user asks to add a new checklist, shopping list, packing list, or structured subtasks to an existing Familia task or plan. Do not use for editing an existing attachment.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- openWorldHint: false
Only reads 12Claude Code: allow
familia_find_free_daysUse this when the user asks to find free days, open dates, vacation windows, long weekends, or consecutive days without hard Familia availability blockers.No findings
Why it is in this group
- The name "familia_find_free_days" says "find": a word for reading.
Description, as the server wrote it Use this when the user asks to find free days, open dates, vacation windows, long weekends, or consecutive days without hard Familia availability blockers. Do not use for listing tasks on one known date.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- openWorldHint: false
familia_get_day_overviewUse this when the user asks for Familia items on a specific date or in a specific time window.No findings
Why it is in this group
- The name "familia_get_day_overview" says "get": a word for reading.
Description, as the server wrote it Use this when the user asks for Familia items on a specific date or in a specific time window. Includes tasks, plans, and connected calendar events. Do not use for broad text search or multi-week availability.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- openWorldHint: false
familia_get_inboxUse this when the user asks for inbox, items needing attention, overdue tasks, past leftovers, unfinished responsibilities, or what is waiting on them.No findings
Why it is in this group
- The name "familia_get_inbox" says "get": a word for reading.
Description, as the server wrote it Use this when the user asks for inbox, items needing attention, overdue tasks, past leftovers, unfinished responsibilities, or what is waiting on them.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- openWorldHint: false
familia_get_next_upUse this when the user asks what is next, what they should do now, their next task, or the next upcoming family item.No findings
Why it is in this group
- The name "familia_get_next_up" says "get": a word for reading.
Description, as the server wrote it Use this when the user asks what is next, what they should do now, their next task, or the next upcoming family item. Defaults to personal assigned items; use household scope only for family-wide wording. Never describe owner-only tasks as assigned to the current user.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- openWorldHint: false
familia_get_today_scheduleUse this when the user asks about today's agenda, today's tasks, what they are doing today, or what they should do today.No findings
Why it is in this group
- The name "familia_get_today_schedule" says "get": a word for reading.
Description, as the server wrote it Use this when the user asks about today's agenda, today's tasks, what they are doing today, or what they should do today. Includes tasks, plans, Google/calendar events, and an overdue summary.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- openWorldHint: false
familia_get_tomorrow_scheduleUse this when the user asks about tomorrow's agenda, tomorrow's tasks, tomorrow's plans, or what they should prepare for tomorrow.No findings
Why it is in this group
- The name "familia_get_tomorrow_schedule" says "get": a word for reading.
Description, as the server wrote it Use this when the user asks about tomorrow's agenda, tomorrow's tasks, tomorrow's plans, or what they should prepare for tomorrow. Includes tasks, plans, Google/calendar events, and an overdue summary.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- openWorldHint: false
familia_get_weekly_overviewUse this when the user asks about this week, the next week, upcoming days, family schedule for the week, or a multi-day planning overview.No findings
Why it is in this group
- The name "familia_get_weekly_overview" says "get": a word for reading.
Description, as the server wrote it Use this when the user asks about this week, the next week, upcoming days, family schedule for the week, or a multi-day planning overview.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- openWorldHint: false
familia_list_attachmentsUse this when the user asks what photos, checklists, or list attachments are attached to an existing Familia task or plan.No findings
Why it is in this group
- The name "familia_list_attachments" says "list": a word for reading.
Description, as the server wrote it Use this when the user asks what photos, checklists, or list attachments are attached to an existing Familia task or plan. Use before editing an existing list attachment when the attachment id is unknown.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- openWorldHint: false
familia_list_household_membersUse this when a task or plan must be assigned to, owned by, or shared with a named household member and their Familia user id is not already known.No findings
Why it is in this group
- The name "familia_list_household_members" says "list": a word for reading.
Description, as the server wrote it Use this when a task or plan must be assigned to, owned by, or shared with a named household member and their Familia user id is not already known.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- openWorldHint: false
familia_list_householdsUse this when the user asks which Familia households, families, or shared boards are available.No findings
Why it is in this group
- The name "familia_list_households" says "list": a word for reading.
Description, as the server wrote it Use this when the user asks which Familia households, families, or shared boards are available. Includes member names and user ids for assigning tasks or plans. Do not use for listing tasks, plans, or calendar events.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- openWorldHint: false
familia_list_past_dueUse this when the user asks for overdue items, past leftovers, missed tasks, unfinished items from previous days, or Czech “resty”.No findings
Why it is in this group
- The name "familia_list_past_due" says "list": a word for reading.
Description, as the server wrote it Use this when the user asks for overdue items, past leftovers, missed tasks, unfinished items from previous days, or Czech “resty”. Calendar events are excluded.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- openWorldHint: false
familia_search_itemsUse this when the user asks to find Familia tasks, plans, or connected calendar events by title, notes, description, or location.No findings
Why it is in this group
- The name "familia_search_items" says "search": a word for reading.
Description, as the server wrote it Use this when the user asks to find Familia tasks, plans, or connected calendar events by title, notes, description, or location. Do not use for public web search or unrelated document search.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- openWorldHint: false
This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.
Install
Pinned to version 0.9.0. Values in angle brackets are yours to fill in.
claude mcp add --transport http familia https://mcp.family.asynq.org/mcp --header 'Authorization: <your-authorization>'Run in a terminal.
Claude Code permissions
Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.
{
"permissions": {
"allow": [
"mcp__familia__familia_list_households",
"mcp__familia__familia_list_household_members",
"mcp__familia__familia_get_day_overview",
"mcp__familia__familia_get_today_schedule",
"mcp__familia__familia_get_tomorrow_schedule",
"mcp__familia__familia_get_next_up",
"mcp__familia__familia_get_weekly_overview",
"mcp__familia__familia_get_inbox",
"mcp__familia__familia_list_past_due",
"mcp__familia__familia_search_items",
"mcp__familia__familia_list_attachments",
"mcp__familia__familia_find_free_days"
],
"ask": [
"mcp__familia__familia_create_list_attachment"
],
"deny": [
"mcp__familia__familia_create_task",
"mcp__familia__familia_create_list_task",
"mcp__familia__familia_attach_image",
"mcp__familia__familia_update_list_attachment",
"mcp__familia__familia_delete_attachment",
"mcp__familia__familia_create_plan",
"mcp__familia__familia_update_task",
"mcp__familia__familia_cancel_task",
"mcp__familia__familia_delete_task",
"mcp__familia__familia_update_plan",
"mcp__familia__familia_delete_plan",
"mcp__familia__familia_batch_write"
]
}
}Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as familia. Review it before you use it.