Famboard

io.github.CloudCorpRecords由 GitHub 帳號 CloudCorpRecords 發布v0.1.0更新於 Nov 7, 2026

Family planner for schedules, tasks, checklists, plans and attachments, shared by household.

已驗證STDIO僅桌面效率與工作流溝通與協作

概覽

AI 產生的概覽

連接 Familia 家庭行程規劃服務的本地 stdio 橋接,讓助理查看行程並建立或修改共享任務、計畫與清單。

可以做什麼
  • 列出家庭與成員,讀取某日、今天、明天、本週及接下來事項的行程,以及待處理與逾期內容
  • 依文字搜尋任務、計畫和行事曆事件,並找出連續空閒的日子
  • 建立任務、清單任務和計畫項目,支援重複規則
  • 更新、取消或永久刪除任務與計畫,或將多個寫入當成一個有序批次執行
  • 列出、附加、取代和刪除任務或計畫上的照片與清單附件
適用情境
適合家庭已在 Familia 中共同安排事務,並希望助理回答今天有什麼、哪些逾期、接下來要做什麼,或把家事、採買清單、出遊與活動加入共享看板的情況。
執行需求
以 stdio 本地程序執行,可透過 npx 或 Docker 映像啟動;需要能連線到上游 Familia MCP 端點。選用環境變數 FAMILIA_MCP_URL 可覆寫端點,選用 FAMILIA_API_KEY 會以 Bearer 授權標頭送出;未設定時不送出授權標頭。清單中未宣告帳號設定。
安裝前請注意
寫入會直接作用於真實的 Familia 家庭資料:建立、更新、取消和刪除任務或計畫,以及刪除附件,都會對家庭成員可見或無法復原。更新與計畫變更可能通知成員並重排重複事項。若設定了 FAMILIA_API_KEY,該憑證會被轉送到上游端點,因此只應把 FAMILIA_MCP_URL 指向可信主機。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Famboard,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

famboard

famboard is a small local bridge to Familia's hosted MCP server, a planner that households share for their schedules, tasks, checklists, plans and attachments.

The bridge keeps no family data and plans nothing on its own. It serves the upstream server's tool list locally, exactly as captured from the live endpoint, and forwards each tool call upstream, returning the result untouched. Reads and writes alike travel that path: creating a task or editing a plan through famboard is creating or editing it in Familia itself, on the caller's own households.

Tools

Schedule and overview reads:

  • familia_list_households — the households, families or shared boards available to the caller, with member names and user ids. No arguments.
  • familia_list_household_members — active and pending members of one household. Required: householdId.
  • familia_get_day_overview — tasks, plans and calendar events for a date or time window.
  • familia_get_today_schedule — today's agenda, with an overdue summary.
  • familia_get_tomorrow_schedule — tomorrow's agenda, with an overdue summary.
  • familia_get_next_up — the next upcoming items, in personal or household scope.
  • familia_get_weekly_overview — a multi-day planning overview, 1 to 14 days.
  • familia_get_inbox — items needing attention.
  • familia_list_past_due — overdue tasks and other unfinished leftovers; calendar events are excluded.
  • familia_search_items — find tasks, plans and calendar events by text. Required: query.
  • familia_find_free_days — runs of consecutive days without hard availability blockers. No required arguments.

Tasks and plans:

  • familia_create_task — a responsibility-style task, chore or reminder, optionally recurring or carrying a checklist. Required: householdId, title.
  • familia_create_list_task — a shopping list, packing list or other checklist task. Required: householdId, title, items.
  • familia_create_plan — a plan item for an event, trip, school activity, holiday or similar. Required: householdId, title.
  • familia_update_task — rename, reschedule, reassign or complete a task. Required: agreementId.
  • familia_cancel_task — cancel a task without deleting its record. Required: agreementId.
  • familia_delete_task — permanently delete a task. Required: agreementId.
  • familia_update_plan — edit a plan's title, schedule, location, participants or linked tasks. Required: planItemId.
  • familia_delete_plan — delete a plan item. Required: planItemId.
  • familia_batch_write — run several task, list-task, plan or attachment writes as one ordered batch. Required: operations.

Attachments:

  • familia_list_attachments — photos and lists attached to a task or plan. Required: targetType, targetId.
  • familia_attach_image — attach a JPEG, PNG or WebP image to a task or plan. Required: targetType, targetId.
  • familia_create_list_attachment — add a new checklist to a task or plan. Required: targetType, targetId, items.
  • familia_update_list_attachment — replace the contents of an existing list attachment. Required: attachmentId, items.
  • familia_delete_attachment — delete a photo or list attachment. Required: attachmentId.

Configuration

  • FAMILIA_MCP_URL (optional) — override the upstream endpoint. Defaults to https://mcp.family.asynq.org/mcp. (The override hook is this rebuild's own labelled reconstruction.)
  • FAMILIA_API_KEY (optional) — when set, every upstream request carries an Authorization: Bearer <key> header. When it is not set, no auth header is sent. (This forwarding is also a labelled reconstruction; the original surface was captured keyless.)

Forwarding mechanics

On the first tool call the client opens a streamable HTTP session with the upstream: a JSON-RPC initialize request (protocolVersion 2025-03-26, clientInfo name famboard), then a notifications/initialized notification, then the tools/call request carrying the caller's arguments unchanged. When the upstream answers initialize with an Mcp-Session-Id header, that value rides on every later request of the session, which is reused for the life of the process. Replies may arrive as plain JSON or as server-sent events; both are read.

Successful upstream results pass through verbatim, including any isError flag the upstream sets. Failures — a JSON-RPC error, a non-2xx status, an unreadable response, or a request that cannot be completed — come back as an isError result whose text starts with famboard error: (this rendering is this rebuild's own labelled reconstruction).

CLI

Each tool is also a subcommand taking one JSON argument string (omit it for tools that take none):

bash
npx @reneturcios/famboard familia_list_householdsnpx @reneturcios/famboard familia_search_items '{"query":"dentist"}'npx @reneturcios/famboard familia_create_task '{"householdId":"hh-1","title":"Take bins out"}'npx @reneturcios/famboard --version

Exit codes: 0 on success, 1 on an isError result, 2 on a usage error.

MCP server

bash
npx -y @reneturcios/famboard mcp

MCP client config:

json
{  "mcpServers": {    "famboard": {      "command": "npx",      "args": ["-y", "@reneturcios/famboard", "mcp"]    }  }}

Docker

bash
docker run -i ghcr.io/cloudcorprecords/famboarddocker run --rm ghcr.io/cloudcorprecords/famboard --version

The container's default command is mcp, so the first form is a stdio MCP server; any other arguments reach the CLI normally.

Development

bash
npm installnpm run buildnpm testnpm run dev

The test suite runs entirely against a stubbed JSON-RPC upstream — no live network calls.

License

MIT — see LICENSE.

來源:README.md,提交 3f2d8b4

工具

25

familia_list_households

List Familia households

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.

無需輸入參數。

familia_list_household_members

List Familia household members

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.

輸入參數timezonehouseholdId必填

familia_get_day_overview

Get day overview

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.

輸入參數dateendAtstartAttimezonehouseholdIdincludeCompleted

familia_get_today_schedule

What am I doing today?

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.

輸入參數timezonehouseholdId

familia_get_tomorrow_schedule

What am I doing tomorrow?

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.

輸入參數timezonehouseholdId

familia_get_next_up

Next up

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.

輸入參數limitscopetimezonehouseholdId

familia_get_weekly_overview

Weekly overview

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.

輸入參數daystimezonestartDatehouseholdId

familia_get_inbox

Inbox / needs attention

Use this when the user asks for inbox, items needing attention, overdue tasks, past leftovers, unfinished responsibilities, or what is waiting on them.

輸入參數limittimezonehouseholdId

familia_list_past_due

List past leftovers

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.

輸入參數limittimezonehouseholdId

familia_search_items

Search family board items

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.

輸入參數limitquery必填offsettimezonehouseholdId

familia_create_task

Create task

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.

輸入參數dueAttitle必填allDaytimezonetodoListrepeatRuledescriptionhouseholdId必填leadMinutesownerUserIdassigneeUserIdidempotencyKey另有 1 個

familia_create_list_task

Create list task

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.

輸入參數dueAtitems必填title必填allDaytimezonelistTitlerepeatRuledescriptionhouseholdId必填leadMinutesownerUserIdassigneeUserId另有 2 個

familia_list_attachments

List attachments

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.

輸入參數targetId必填timezonetargetType必填

familia_attach_image

Attach image

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.

輸入參數widthheightdataUrlfileNamemimeTypetargetId必填timezonebase64DatatargetType必填replaceExistingPhoto

familia_create_list_attachment

Create list attachment

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.

輸入參數items必填titletargetId必填timezonetargetType必填

familia_update_list_attachment

Update list attachment

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.

輸入參數items必填titletimezoneattachmentId必填

familia_delete_attachment

Delete attachment

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.

輸入參數timezoneattachmentId必填

familia_create_plan

Create plan

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.

輸入參數kindendAtnotesrruletitle必填allDaystartAtlocationtimezonehouseholdId必填agreementIdsrelatedTasks另有 4 個

familia_update_task

Update task

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.

輸入參數dueAttitlestatustimezonerepeatRuleagreementId必填descriptionownerUserIdassigneeUserIdvisibleToHousehold

familia_cancel_task

Cancel task

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.

輸入參數timezoneagreementId必填

familia_delete_task

Permanently delete task

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.

輸入參數timezoneagreementId必填

familia_update_plan

Update plan

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.

輸入參數kindendAtnotestitleallDaystartAtlocationtimezoneplanItemId必填agreementIdsparticipantUserIdsrequiresConfirmation

familia_delete_plan

Delete plan

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.

輸入參數timezoneplanItemId必填

familia_batch_write

Batch write Familia items

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.

輸入參數timezoneoperations必填idempotencyKeycontinueOnError

familia_find_free_days

Find consecutive free days

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.

輸入參數limittimezonestartDatebusyEndHourhorizonDayshouseholdIdbusyStartHourblockingPolicyconsecutiveDays

版本歷史

1
  1. v0.1.0最新Nov 4, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分