How do I install the Read Trello Tasks skill?

Run npx skillmds@latest add sainytk/read-trello-tasks in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Read Trello Tasks safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Read Trello Tasks?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Read Trello Tasks free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Read Trello Tasks?

sainytk (@sainytk) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Read Trello Tasks by sainytk — Agent Skill

Name: Read Trello Tasks
Author: sainytk

Read Trello Tasks

Read/search Trello boards, lists, cards, and checklist tasks visible to Sainy's logged-in Trello user via a local API-key plus token login. Use when the user asks to read, check, search, summarize, or inspect Trello tasks.

sainytk e2490e1 4 files · 22.0 KB Updated Sep 17, 2026

File contents

read-trello-tasks

Read/search Trello tasks through a local Trello API key and user token. Trello tasks are represented as cards, with checklist items included when available.

Important

Use the script in this skill directory; invoke with bun.
Secrets may live in .agents/skills/read-trello-tasks/.env; never print or read that file into chat.
Token storage defaults to .agents/skills/read-trello-tasks/.data/trello-token.json; do not print token contents.
.env and .data/ are gitignored.
Prefer board ID/list ID/card ID when available. Trello names are not unique.

Setup / status

From repo root:

bun .agents/skills/read-trello-tasks/scripts/trello.ts status

If not logged in:

bun .agents/skills/read-trello-tasks/scripts/trello.ts login

The login command opens Trello authorization and waits for the localhost callback.

Trello API key

Create a Trello Power-Up/API key at:

https://trello.com/power-ups/admin

Put the key in .agents/skills/read-trello-tasks/.env:

TRELLO_API_KEY=your_api_key

Default redirect URL:

http://localhost:3458/trello/callback

Commands

Status

bun .agents/skills/read-trello-tasks/scripts/trello.ts status

Account

bun .agents/skills/read-trello-tasks/scripts/trello.ts me
bun .agents/skills/read-trello-tasks/scripts/trello.ts logout

Boards

bun .agents/skills/read-trello-tasks/scripts/trello.ts boards
bun .agents/skills/read-trello-tasks/scripts/trello.ts boards --filter all

Lists

bun .agents/skills/read-trello-tasks/scripts/trello.ts lists --board BOARD_ID
bun .agents/skills/read-trello-tasks/scripts/trello.ts lists --board BOARD_ID --filter all

Cards / Tasks

bun .agents/skills/read-trello-tasks/scripts/trello.ts cards --board BOARD_ID --limit 100
bun .agents/skills/read-trello-tasks/scripts/trello.ts cards --list LIST_ID --limit 50
bun .agents/skills/read-trello-tasks/scripts/trello.ts cards --board BOARD_ID --include-closed

Read Card

Use card ID or short link from cards/search.

bun .agents/skills/read-trello-tasks/scripts/trello.ts card --id CARD_ID

Search

bun .agents/skills/read-trello-tasks/scripts/trello.ts search --query 'invoice' --limit 20

Board / Card Activity

Fetch recent actions (moves, edits, comments, checklist updates, etc.) for a board or a single card.

bun .agents/skills/read-trello-tasks/scripts/trello.ts actions --board BOARD_ID
bun .agents/skills/read-trello-tasks/scripts/trello.ts actions --board BOARD_ID --limit 100
bun .agents/skills/read-trello-tasks/scripts/trello.ts actions --card CARD_ID
bun .agents/skills/read-trello-tasks/scripts/trello.ts actions --board BOARD_ID --filter commentCard

--filter accepts any Trello action type (e.g. commentCard, updateCard, createCard, all). Defaults to all. --limit defaults to 50, max 1000.

Token scope

Default login scope:

read

For future writing/editing flows, set:

TRELLO_SCOPE=read,write

Output Discipline

For large boards/searches, filter or summarize script output instead of dumping raw output.
Never expose tokens, API key, authorization fragments, or raw .env content.
Trello cards may contain sensitive personal/work data; only quote what the user needs.

---name: read-trello-tasksdescription: Read/search Trello boards, lists, cards, and checklist tasks visible to Sainy's logged-in Trello user via a local API-key plus token login. Use when the user asks to read, check, search, summarize, or inspect Trello tasks.---# read-trello-tasksRead/search Trello tasks through a local Trello API key and user token. Trello tasks are represented as cards, with checklist items included when available.## Important- Use the script in this skill directory; invoke with `bun`.- Secrets may live in `.agents/skills/read-trello-tasks/.env`; never print or read that file into chat.- Token storage defaults to `.agents/skills/read-trello-tasks/.data/trello-token.json`; do not print token contents.- `.env` and `.data/` are gitignored.- Prefer board ID/list ID/card ID when available. Trello names are not unique.## Setup / statusFrom repo root:```shbun .agents/skills/read-trello-tasks/scripts/trello.ts status```If not logged in:```shbun .agents/skills/read-trello-tasks/scripts/trello.ts login```The login command opens Trello authorization and waits for the localhost callback.## Trello API keyCreate a Trello Power-Up/API key at:```txthttps://trello.com/power-ups/admin```Put the key in `.agents/skills/read-trello-tasks/.env`:```txtTRELLO_API_KEY=your_api_key```Default redirect URL:```txthttp://localhost:3458/trello/callback```## Commands### Status```shbun .agents/skills/read-trello-tasks/scripts/trello.ts status```### Account```shbun .agents/skills/read-trello-tasks/scripts/trello.ts mebun .agents/skills/read-trello-tasks/scripts/trello.ts logout```### Boards```shbun .agents/skills/read-trello-tasks/scripts/trello.ts boardsbun .agents/skills/read-trello-tasks/scripts/trello.ts boards --filter all```### Lists```shbun .agents/skills/read-trello-tasks/scripts/trello.ts lists --board BOARD_IDbun .agents/skills/read-trello-tasks/scripts/trello.ts lists --board BOARD_ID --filter all```### Cards / Tasks```shbun .agents/skills/read-trello-tasks/scripts/trello.ts cards --board BOARD_ID --limit 100bun .agents/skills/read-trello-tasks/scripts/trello.ts cards --list LIST_ID --limit 50bun .agents/skills/read-trello-tasks/scripts/trello.ts cards --board BOARD_ID --include-closed```### Read CardUse card ID or short link from `cards`/`search`.```shbun .agents/skills/read-trello-tasks/scripts/trello.ts card --id CARD_ID```### Search```shbun .agents/skills/read-trello-tasks/scripts/trello.ts search --query 'invoice' --limit 20```### Board / Card ActivityFetch recent actions (moves, edits, comments, checklist updates, etc.) for a board or a single card.```shbun .agents/skills/read-trello-tasks/scripts/trello.ts actions --board BOARD_IDbun .agents/skills/read-trello-tasks/scripts/trello.ts actions --board BOARD_ID --limit 100bun .agents/skills/read-trello-tasks/scripts/trello.ts actions --card CARD_IDbun .agents/skills/read-trello-tasks/scripts/trello.ts actions --board BOARD_ID --filter commentCard````--filter` accepts any Trello action type (e.g. `commentCard`, `updateCard`, `createCard`, `all`). Defaults to `all`.`--limit` defaults to 50, max 1000.## Token scopeDefault login scope:```txtread```For future writing/editing flows, set:```txtTRELLO_SCOPE=read,write```## Output Discipline- For large boards/searches, filter or summarize script output instead of dumping raw output.- Never expose tokens, API key, authorization fragments, or raw `.env` content.- Trello cards may contain sensitive personal/work data; only quote what the user needs.

Frequently asked questions