Trello
@bmonty/trellov2026.10.26.1
01README
Watch Trello lanes and work cards from swamp workflows: read cards with comments, checklists, attachments, and activity history; move cards, comment, attach files, and manage labels and checklists.
02Behaviors
@bmonty/trellov2026.10.26.1trello/trello.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| apiKey | string | Trello API key (https://trello.com/power-ups/admin). |
| apiToken | string | Trello API token authorized for the board. |
| boardId | string | Board id or short link (the `abc123` in trello.com/b/abc123/name). |
fn listLists()
List the board's open lanes (useful to find list ids)
fn listCards(list: string, member?: string, includeDetails?: boolean)
List open cards in a lane, optionally only those assigned to a member
| Argument | Type | Description |
|---|---|---|
| list | string | List id or exact list name. |
| member? | string | Only cards assigned to this member (username or id). |
| includeDetails? | boolean | Also write full detail (`card-<id>`) for every matching card. |
fn getCard(card: string)
Get a card's full detail: description, checklists, custom fields, attachments, comments
| Argument | Type | Description |
|---|---|---|
| card | string | Card id or short link. |
fn moveCard(card: string, list: string, position?: enum)
Move a card to another lane on the board (no-op if already there)
| Argument | Type | Description |
|---|---|---|
| card | string | Card id or short link. |
| list | string | Target list id or exact name. |
| position? | enum | Where to place the card in the target lane. |
fn addComment(card: string, text: string, skipIfContains?: string)
Post a comment (markdown) to a card
| Argument | Type | Description |
|---|---|---|
| card | string | Card id or short link. |
| text | string | Comment text; Trello renders markdown. Max 16384 characters. |
| skipIfContains? | string | Don't post if an existing comment contains this text; makes the call safe to retry. |
fn attachFile(card: string, name: string, content?: string, path?: string, mimeType?: string, replaceExisting?: boolean)
Upload a file to a card from text content or a local path, optionally replacing same-named attachments
| Argument | Type | Description |
|---|---|---|
| card | string | Card id or short link. |
| name | string | File name shown on the card. |
| content? | string | Text content to upload. Give exactly one of content or path. |
| path? | string | Local file to upload. Give exactly one of content or path. |
| mimeType? | string | MIME type of the file. |
| replaceExisting? | boolean | After uploading, delete older attachments with the same name. |
fn updateLabels(card: string, add?: array, remove?: array)
Add and/or remove board labels on a card (by name or id; idempotent)
| Argument | Type | Description |
|---|---|---|
| card | string | Card id or short link. |
| add? | array | Labels to add. |
| remove? | array | Labels to remove. |
fn addChecklistItems(card: string, checklist: string, items: array, skipExisting?: boolean)
Add items to a named checklist on a card, creating the checklist if needed
| Argument | Type | Description |
|---|---|---|
| card | string | Card id or short link. |
| checklist | string | Checklist name (case-insensitive); created if missing. |
| items | array | Item texts. |
| skipExisting? | boolean | Skip items whose text already exists in the checklist. |
fn setCheckItemState(card: string, item: string, state: enum)
Mark a checklist item complete or incomplete
| Argument | Type | Description |
|---|---|---|
| card | string | Card id or short link. |
| item | string | Checklist item id. |
| state | enum |
fn getCardActions(card: string, types?: array, since?: string)
Get a card's activity history (who did what, when), oldest first
| Argument | Type | Description |
|---|---|---|
| card | string | Card id or short link. |
| types? | array | Trello action types, e.g. commentCard, updateCard, addAttachmentToCard. |
| since? | string | Only actions after this action id or ISO date. |
Resources
boardLists(infinite)— Open lists (lanes) on the board
cardList(infinite)— Cards in one lane, optionally filtered to one member
card(infinite)— Full detail for one card
move(infinite)— Result of moving a card (`move-<cardId>`)
comment(infinite)— A comment posted to a card (`comment-<actionId>`)
upload(infinite)— A file attached to a card (`upload-<attachmentId>`)
labels(infinite)— A card's labels after `updateLabels` (`labels-<cardId>`)
checklist(infinite)— A checklist after a change (`checklist-<checklistId>`)
actions(infinite)— A card's activity history (`actions-<cardId>`)
Files
attachment(application/octet-stream)— Downloaded card attachment (`attachment-<attachmentId>`)
03Stats
A
100 / 100
Downloads
3
Archive size
24.8 KB
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types (deprecated)1/1earned
- Dependencies pass trust audit2/2earned
- Docs keep secrets in a vault1/1earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License2/2earned
- Verified public repository2/2earned
04Platforms
05Labels