@kody/trello
Read and update Trello boards, lists, cards, and comments with dry-run mutations.
OtherTopics: trello, boards, lists, cards, comments, oauth, api-key, token, dry-run
- Version
- 1.0.0
- License
- MIT
- Published
- September 10, 2026
- Pinned commit
7b68b13- Rating
- No ratings yet
- Forks
- 0
- Adaptation effort
- —
README
Agent docs@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.
| Lane | When to use | Credential |
|---|---|---|
| API key + token (recommended) | Personal automation, Power-Up key | User secrets trelloApiKey + trelloToken (or trelloApiKey-<purpose> / trelloToken-<purpose>) |
| OAuth integration | Saved trello / trello-* connection | createAuthenticatedFetch 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
- Create a Power-Up and API key at Trello Power-Ups admin
- 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
- Authorize a user token with that key (
read,write; replaceYOUR_API_KEYwith 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
- 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
- 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+trelloTokenare saved (or OAuthtrellois connected); hostapi.trello.comis approved- Smoke test returns
ok: true(live member/boards sample when credentials exist) - Live writes refuse unless
confirm: true;dryRun: truenever 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/
Report this listing
Log in to report this listing.