Favro

Delete a Favro card by its per-widget cardId. With `everywhere: false` (default) only this widget's instance is removed — other widgets sharing the same cardCommonId keep their copies. With `everywhere: true` the card is purged from EVERY widget — irreversible. Returns the list of cardIds Favro deleted. Successful live writes invalidate the search-cards cache. Destructive — MCP hosts may warn before auto-confirming. Pass `dry_run: true` to preview.

Delete a Favro collection by its collectionId. Destructive — MCP hosts may warn before auto-confirming. Favro does not cascade-delete widgets when a collection is removed; widgets that lived only in this collection may become orphaned. On success the collection / widget / search-cards caches are invalidated. Pass `dry_run: true` to preview.

Delete a Favro column by its columnId. Destructive — MCP hosts may warn before auto-confirming. Favro forbids deleting a column that contains cards (returns HTTP 400); move or archive the cards out first. Pass `widget_common_id` if known for scoped cache invalidation. Pass `dry_run: true` to preview.

Delete a Favro comment by its commentId. Destructive — MCP hosts may warn before auto-confirming. Pass `dry_run: true` to preview.

Remove one dependency link from a Favro card. The cards themselves are untouched — only the link between them goes away. Pass `dry_run: true` to preview.

Delete a Favro group by its groupId. Destructive — MCP hosts may warn before auto-confirming. The group is removed from any sharing / assignment / custom-field references it appeared in. Successful live writes invalidate the group cache. Pass `dry_run: true` to preview.

Delete an org-global Favro tag by its tagId. The tag is removed from every card it was applied to — Favro does not soft-delete tags. On a successful live delete the org's tag cache is invalidated so the next resolve / list call re-fetches. Pass `dry_run: true` to preview the request without contacting Favro. Destructive — MCP hosts may warn users before auto-confirming.

Delete a Favro checklist item by its taskId. Destructive — MCP hosts may warn before auto-confirming. Pass `dry_run: true` to preview.

Delete a Favro checklist and every item in it. Destructive — MCP hosts may warn before auto-confirming. Pass `dry_run: true` to preview.

Delete an outgoing webhook by `webhook_id`. Favro stops posting card events to that address immediately, and whatever was consuming them stops receiving them — this server cannot tell you what that is, so confirm with a human before removing a webhook you did not create. Resolve the id with `favro_list_webhooks`. Pass `dry_run: true` to preview.

Delete a Favro widget by its widgetCommonId. Destructive — MCP hosts may warn before auto-confirming. Cards on the widget are removed; columns on the widget become inaccessible. Pass `collection_id` to remove the widget from just that collection, or `everywhere: true` to delete every instance across all collections the widget belongs to; one of the two is required. On success the widget / column / search-cards caches are invalidated. Pass `dry_run: true` to preview.

Get a single Favro card by its per-widget cardId. Favro's GET endpoint only accepts the per-widget cardId — passing a cardCommonId here 403s. To fetch a card known only by cardCommonId, use favro_list_cards with that filter. Pass `description_format: "markdown"` to see the description as Favro stored it. Read-only.

Fetch one Favro card with every id field dereferenced into a human-readable name: tag IDs → tag names, assignee userIds → user names + emails, widgetCommonId → widget name, columnId → column name, collectionIds (from the parent widget) → collection names, customFieldId → custom field name + display value. Custom-field display values cover Text, Number, Date, Date created, Checkbox, Link, Single select, Multiple select, Status (name + color), Members (resolved to user names), Rating ('value / total'), Timeline ('start → due'), Voting (yes/no), Progress (percent), Tags (resolved to tag names), S…

Get a single Favro collection by id. Read-only.

Get a single Favro column by its columnId. Read-only.

Get a single Favro comment by its commentId. Read-only.

Get a single Favro custom field by its customFieldId. Read-only.

Get a single Favro group by its groupId. Read-only.

Get the Favro organization this server is bound to — its name, id and membership. Takes no input: the server is single-org, binds one organization at startup, and Favro routes this call by a header rather than by the id in the path. Use `favro_list_organizations` to see every organization the token can reach. Read-only.

Get a single Favro tag by its tagId. Read-only.

Get a single Favro checklist item by its taskId. Read-only.

Get a single Favro checklist by its taskListId. Read-only.

Get a single Favro user by id. Read-only.

Get a single Favro widget by its widgetCommonId. Read-only.

Read a Favro card's activity history — who changed what, and when. Answers "when did this move to Done", "who reassigned this", "what changed since Friday". `card_id` is the per-widget cardId, NOT the cardCommonId. Narrow with `since` / `until` (ISO 8601) rather than paging through everything. Which fields an entry carries depends on its `type`: a column move fills column_id / column_name, a custom-field edit fills custom_field_name / custom_field_value, a comment fills comment_id. `by_user_id` resolves to a name via favro_get_user. Returns one page; pass `page` plus the prior `request_id` (an…

List Favro cards with optional filters: `widget_common_id` (single widget), `collection_id` (cards in any widget of that collection), `card_common_id` (every instance of one card), `sequential_id` (per-card integer counter). Pass `unique=true` to dedupe cards that live on multiple widgets. Returns one page; pass `page` (1-indexed) plus the `request_id` from the prior response (and the SAME filters again) to retrieve subsequent pages. Read-only.

List Favro collections in the organization the API token is scoped to. Pass `archived: true` to include archived collections. Returns one page; pass `page` (1-indexed) plus the `request_id` from the prior response to retrieve subsequent pages. Read-only.

List Favro columns (status lanes) on a single widget. `widget_common_id` is REQUIRED — Favro rejects unfiltered listings with 400. Items are sorted by `position` ascending (left-to-right board order); Favro itself returns them in columnId order, which is meaningless to humans. Returns one page; pass `page` (1-indexed) plus the `request_id` from the prior response (and `widget_common_id` again) to retrieve subsequent pages. Read-only.

List comments on a single Favro card. `card_common_id` is REQUIRED (the cross-widget card identity, not the per-widget cardId). Returns one page; pass `page` (1-indexed) plus the `request_id` from the prior response (and `card_common_id` again) to retrieve subsequent pages. Read-only.

List Favro custom fields in the active organization. Custom fields are org-global (no widget or card scope). Each entry includes the field's `type` (Favro's display label — e.g. "Text", "Number", "Date", "Checkbox", "Single select", "Multiple select", "Members", "Tags", "Rating", "Link", "Progress", "Voting", "Relations", "Sequential ID", "Timeline"; Favro extends this set without notice) and, for select-flavored types, a `customFieldItems` list of legal options. Returns one page; pass `page` (1-indexed) plus the `request_id` from the prior response to retrieve subsequent pages. Read-only.

List a Favro card's dependencies — the before/after links to other cards. Not paginated: Favro returns the full list in one response. Each entry names the other card and whether it comes before or after this one. Read-only.

List Favro groups (named user collections) in the active organization. Groups are org-global (no widget or card scope). Each entry includes the group's `members` list, where each member is a `{userId, role}` pair. Returns one page; pass `page` (1-indexed) plus the `request_id` from the prior response to retrieve subsequent pages. Read-only.

List Favro organizations the API token can see. Returns one page; pass `page` (1-indexed) plus the `request_id` from the prior response to retrieve subsequent pages. Read-only.

List Favro tags in the active organization. Tags are org-global (no widget or card scope). Pass `name` for an exact-match server-side filter. Returns one page; pass `page` (1-indexed) plus the `request_id` from the prior response to retrieve subsequent pages. Read-only.

List the checklists on a Favro card. Favro calls them "tasklists"; their items are "tasks" (see favro_list_tasks). `card_common_id` is REQUIRED (the cross-widget card identity, not the per-widget cardId). Returns one page; pass `page` plus the prior `request_id` (and `card_common_id` again) for later pages. Read-only.

List checklist items on a Favro card. Favro calls checklist items "tasks" and the checklists that hold them "tasklists". `card_common_id` is REQUIRED (the cross-widget card identity, not the per-widget cardId); add `task_list_id` to narrow to one checklist. Returns one page; pass `page` plus the prior `request_id` (and `card_common_id` again) for later pages. favro_get_card_full already reports the done/total counts, so reach for this when the individual item names matter. Read-only.

List members of the Favro organization the API token is scoped to. Returns one page; pass `page` (1-indexed) plus the `request_id` from the prior response to retrieve subsequent pages. Read-only.

List the outgoing webhooks configured in the organization — the addresses Favro posts card events to. Optional `widget_common_id` narrows to one board. Favro returns every webhook at once — this is the one collection it does not paginate — so there is no `page`. The signing secret is deliberately NOT returned: it is what authenticates deliveries to whoever consumes them. There is no tool to create a webhook, because a webhook needs a receiver that outlives this process and a stdio server is not one; use this to see what exists and `favro_delete_webhook` to remove it. Read-only.

List Favro widgets (boards) in the organization the API token is scoped to. Pass `collection_id` to scope the result to a single collection. Pass `archived: true` to include archived widgets. Returns one page; pass `page` (1-indexed) plus the `request_id` from the prior response to retrieve subsequent pages. Read-only.

Description is built at runtime.

Liveness check. Returns the server version, the bound Favro organization id, and which credential source is active. Does NOT contact Favro — this is a local diagnostic, not a connectivity test.

Prepend markdown text to a Favro card's description, preserving the existing markdown structure. Reads the card with `descriptionFormat=markdown`, PUTs `detailedDescription = text + '\n\n' + old`. Returns `{old, new, unified_diff}`. Successful live writes invalidate the search-cards cache. Pass `dry_run: true` to preview.

Reports the most recently observed Favro rate-limit headers (X-RateLimit-Limit / Remaining / Reset / Delay, plus Retry-After on 429). Read-only and does NOT contact Favro — it surfaces what the client already saw on prior requests so the caller can decide whether to slow down. A non-zero `throttle_delay_seconds` is the early warning: Favro is already stalling responses to refill the token bucket, and starts rejecting with 429 once the needed stall would exceed 10 seconds.

Detach one or more files from a Favro card. Favro has no per-attachment DELETE — removal rides on `removeAttachments` in PUT /cards/{cardId}, matched by attachment URL rather than display name. Pass the `fileURL` values from favro_get_card_full or favro_upload_attachment as-is: those URLs are presigned and re-minted on every read, so the tool strips the query string down to the stable object URL before sending. Favro returns HTTP 200 whether or not anything matched, so verify by re-reading the card. Successful live writes invalidate the search-cards cache. Pass `dry_run: true` to preview.

Remove an org-global tag from a Favro card by tag NAME. Hard-fails if the name doesn't match exactly. Successful live writes invalidate the search-cards cache. Pass `dry_run: true` to preview.

Description is built at runtime.

Description is built at runtime.

Description is built at runtime.

Description is built at runtime.

Description is built at runtime.

Description is built at runtime.

Description is built at runtime.

Description is built at runtime.

Description is built at runtime.

Search Favro cards by name and description, ranked locally because the Favro API has no full-text search. Exactly one of `widget_common_id` (single board) or `collection_id` (single collection) is required — Favro's /cards endpoint rejects unfiltered listings, so org-wide search is not supported; call favro_resolve_widget or favro_resolve_collection first if you don't know the scope. Markdown in descriptions is stripped before matching. `column_name` is intentionally omitted from each result (resolving columns per-hit would burn the rate-limit budget the cache exists to protect); chain to favr…

Set a single custom-field value on a Favro card. Supply exactly one kind of value input, matching the resolved field's Type: • Text → `text` • Number → `number` • Date → `date` (ISO 8601) • Checkbox → `checkbox` • Vote → `vote` • Color → `color` • Single select → `single_select_item_id` • Status → `status_item_id` • Multiple select → `multi_select_item_ids` (replaces the selection) • Members → `add_member_user_ids` and/or `remove_member_user_ids` • Tags → `add_tag_ids` and/or `remove_tag_ids` • Rating → `rating_value` (Favro fixes the scale at 0-5) • Link → `link_url`…

Unarchive a Favro card by its per-widget cardId. Convenience over favro_update_card with `archive: false`. Successful live writes invalidate the search-cards cache. Pass `dry_run: true` to preview without contacting Favro.

Description is built at runtime.

Update a Favro collection. Every body field is optional — pass at least one. `archive: true` archives, `archive: false` unarchives, omit to keep current. Membership uses two separate lists: `share_to_users` adds members of the organization or groups who aren't in the collection yet, while `members` re-roles or (with `delete: true`) removes people who already are. Opening the collection to the whole organization or to anyone with its link is favro_widen_collection_sharing; `public_sharing: 'users'` here narrows it back. Successful live writes invalidate the collection cache. Pass `dry_run: true…

Update a Favro column. Every body field is optional — pass at least one. Pass `widget_common_id` if known so the cache invalidation can be scoped to one widget; otherwise every cached column list is dropped on success. Pass `dry_run: true` to preview.

Replace the body of an existing Favro comment. The new `comment` text replaces the existing body in full; surgical edit-in-place is not yet supported. Pass `dry_run: true` to preview without writing.

Description is built at runtime.

Update a Favro group. Both fields optional. `members`, when set, REPLACES the group's member list — compose the full intended list before sending, and drop anyone who should leave. (Favro's docs describe add/remove delta semantics with a per-entry `delete` flag, but a live test observed whole-list replacement; sending the full list is correct under either reading, whereas sending only a delta is not.) Each entry names a person by userId plus a role; someone new must be a member of the organization, and nobody becomes administrator who is not one already. Successful live writes invalidate the g…

Update an org-global Favro tag's name and/or color. Both fields are optional; pass at least one to make a meaningful change. The change propagates to every card the tag is applied to. On a successful live update the org's tag cache is invalidated. Pass `dry_run: true` to preview the request without contacting Favro.

Apply multiple tag updates in one tool call. Favro has no real bulk-tag endpoint, so this fans out to N parallel `PUT /tags/{tagId}` requests under the hood — same total round-trips as N sequential `favro_update_tag` calls, but parallelized. Useful for renaming or recoloring a set of tags (e.g. all 'priority-*' tags) in one shot. Each entry needs `tag_id` plus at least one of `name` or `color`. Resolve names to tagIds via favro_resolve_tag first. Returns the array of updated tags in input order. On the first per-entry error remaining in-flight requests cancel — partial successes may have alrea…

Update a Favro checklist item. Every field is optional — pass at least one. `completed: true` ticks the item, `completed: false` un-ticks it. Pass `dry_run: true` to preview.

Rename or reorder a Favro checklist. Its items are managed separately via favro_create_task / favro_update_task / favro_delete_task. Pass `dry_run: true` to preview.

Update a Favro widget. Every body field is optional — pass at least one. `archive: true` archives, `archive: false` unarchives — both require `collection_id`, because a widget can belong to several collections and Favro scopes the archive to one of them. Successful live writes invalidate the widget cache. Pass `dry_run: true` to preview.

Upload a local file as an attachment on a Favro card via raw-bytes POST. Reads `file_path` from the directory FAVRO_UPLOAD_DIR names, and from nowhere else; this tool exists only when that is set. Then POSTs to `/cards/{cardId}/attachment` with `Content-Type: application/octet-stream` and the filename in the query string. `filename` defaults to the file's basename if omitted. Cap is 8 MiB per upload — larger files surface a typed error before any HTTP work. Returns the created attachment object `{name, fileURL}` (Favro echoes the attachment, NOT the updated Card — verified live). Successful li…

Upload a local file as an attachment on a Favro comment via raw-bytes POST to `/comments/{commentId}/attachment`. Same contract as favro_upload_attachment, but the file lands on a comment rather than on the card itself: reads `file_path` from FAVRO_UPLOAD_DIR only, `filename` defaults to the basename, 8 MiB cap enforced before any HTTP work, returns the created attachment object `{name, fileURL}`. Pass `dry_run: true` to preview.

Open a Favro collection to every member of the organization (`public_sharing: 'organization'`) or to anyone on the internet with its link, without signing in (`'public'`). Nothing takes back what was seen while it was open. Takes `collection_name`, the name Favro holds for the collection, as a witness: a name that differs is refused. favro_create_collection and favro_update_collection refuse these two modes; favro_update_collection with `public_sharing: 'users'` narrows a collection again. The collection is read back after the write and `notes` says whether the mode took. Pass `dry_run: true` …