Skip to content
← Public packages

@kody/trello

Read and update Trello boards, lists, cards, and comments with dry-run mutations.

FollowFork

Files

README.md

106 lines · 4.6 KB · Markdown

@kody/trello

community-icon.svg is Trello's official logomark from the Wikimedia Commons Trello logo (Atlassian product mark, Pacific Bridge gradient #0052CC → #2684FF). Trello® is a trademark of Atlassian. This package is not affiliated with or endorsed by Atlassian.

Share this package as https://kody.codes/@kody/trello (never a /community/{listing_id} URL).

Intent

Reusable Trello helpers so Kody agents can list and update the caller's boards, lists, cards, and comments. Reads are free-form. Mutations support dryRun: true and require confirm: true.

This listing is meant to be forked. After you fork, connect your Trello account. No board ids, list names, or workspace ids are baked in.

What it does

  • List or inspect the caller's boards, lists, cards, and comments
  • Create or update boards, lists, cards, and comments after explicit confirmation
  • Call an unwrapped Trello REST path through ./request
  • Verify credentials with a smoke test before any write

Prerequisites / setup

Trello has no built-in Kody OAuth app. Trello REST still authenticates with an API key + user token (query key and token). Trello OAuth 2 is not generally available; Kody can still use a saved trello / trello-* integration when one exists.

LaneWhen to useCredential
API key + token (recommended)Personal automation, Power-Up keyUser secrets trelloApiKey + trelloToken (or trelloApiKey-<purpose> / trelloToken-<purpose>)
OAuth integrationSaved trello / trello-* connectioncreateAuthenticatedFetch via integrationName

Required API host: api.trello.com. Approve it in the account secrets UI. Saving a secret does not approve hosts by itself. Never paste keys or tokens into chat.

Lane A — API key + token
  1. Create a Power-Up and API key at Trello Power-Ups admin
  2. Save the API key (do not paste the value in chat):

https://kody.codes/account/secrets/new?name=trelloApiKey&description=Trello%20API%20key%20for%20boards%2C%20lists%2C%20cards%2C%20and%20comments&allowedHosts=api.trello.com&scope=user

  1. Authorize a user token with that key (read,write; replace YOUR_API_KEY with the key you just created — in the Trello page, not in chat):

https://trello.com/1/authorize?expiration=never&name=Kody&scope=read%2Cwrite&response_type=token&key=YOUR_API_KEY

  1. Save the user token:

https://kody.codes/account/secrets/new?name=trelloToken&description=Trello%20user%20token%20for%20boards%2C%20lists%2C%20cards%2C%20and%20comments&allowedHosts=api.trello.com&scope=user

  1. Approve host api.trello.com
Lane B — Saved OAuth integration

Trello's live OAuth is 1.0 (/1/OAuthGetRequestToken, /1/OAuthAuthorizeToken, /1/OAuthGetAccessToken). Kody /connect/oauth is OAuth 2, so a first-time Trello OAuth 2 connect is not available until Atlassian ships those endpoints.

If a trello integration is already saved, reconnect while signed in to Kody:

https://kody.codes/connect/oauth?provider=trello

For a new BYO connection page (provider + API host prefilled; add authorize and token URLs when Trello documents OAuth 2):

https://kody.codes/connect/oauth?provider=trello&apiBaseUrl=https%3A%2F%2Fapi.trello.com%2F1&allowedHosts=api.trello.com&dashboardUrl=https%3A%2F%2Ftrello.com%2Fpower-ups%2Fadmin&flow=confidential

Redirect URI for any future Trello OAuth 2 app: https://kody.codes/connect/oauth.

To connect a second account, change provider (for example provider=trello-work) and pass account: 'work' or integrationName: 'trello-work' / secretName: 'trelloToken-work' / apiKeySecretName: 'trelloApiKey-work' on every call.

Agents: see AGENTS.md for import paths, smoke checks, and mutation guards.

Done when

  • trelloApiKey + trelloToken are saved (or OAuth trello is connected); host api.trello.com is approved
  • Smoke test returns ok: true (live member/boards sample when credentials exist)
  • Live writes refuse unless confirm: true; dryRun: true never contacts Trello
  • Board/list/card ids always come from the caller — this package has no default board

Jobs

account-health calls ./scheduled-account-health weekly (Monday 09:00 UTC). It is enabled: false. Enabling it is an operator choice after you fork and confirm the read is right for your account.

Branding

Keep LICENSE (MIT), ## Intent, and community-icon.svg intact for community listing.

Auth docs

https://developer.atlassian.com/cloud/trello/guides/rest-api/authorization/