Trello Planner
Read-only Trello planner using official Boards API. π§ AI PLANNING: Task prioritization, sprint capacity, board optimization π ANALYSIS: Lists/cards/members from /boards/{id}/* endpoints π SEARCH: Overdue, assignees, labels across boards REQUIRES: TRELLO_API_KEY + TRELLO_TOKEN (read scope) ENDPOINTS: /1/boards/{id}/lists, /cards, /members (official spec)
Trello Planner - Official Boards API
https://developer.atlassian.com/cloud/trello/rest/api-group-boards/
π Setup (Read-Only Token)
1. https://trello.com/app-key β API Key
2. https://trello.com/1/authorize?key=[YOUR_KEY]&name=TrelloPlanner&scope=read&expiration=never β Token
3. Test: https://api.trello.com/1/members/me/boards?key=[KEY]&token=[TOKEN]
Verified Endpoints (Boards Group)
| Endpoint | Purpose | Params | Docs |
|---|---|---|---|
GET /1/members/me/boards | User boards | fields=name,id | [MembersβBoards] |
GET /1/boards/{id}/lists | Lists on board | fields=name,id,closed | [Boards API] |
GET /1/boards/{id}/cards | All cards | fields=name,due,idList,closed | [Boards API] |
GET /1/boards/{id}/members | Team members | fields=username,fullName | [Boards API] |
GET /1/search | Overdue cards | query="due:<now" | [Search API] |
π Example Usage & Output
Query: /trello-plan Engineering
{
"status": "success",
"data": {
"board_name": "Engineering Sprint 42",
"cards_open": 18,
"overdue_count": 2,
"planner_insights": ["π¨ PRIORITY: Fix login (overdue 2d)", "βοΈ Review overloaded (8 cards)"],
"health_score": "π‘ Needs attention"
}
}
Do's & Don'ts
β DO:
- Parallel
/boards/{id}/lists+cards+members fields=param limiting- Cache 30min (boards stable)
β DON'T:
- Write endpoints (POST/PUT/DELETE)
- Full card fields (attachments slow)
- Log tokens (security)
π§ͺ Test Cases (Verified Post-Fix)
| Test | Expected |
|---|---|
| No token | error_type: "auth" + setup URLs |
| Closed cards | Properly excluded from openCards |
| Large boards | limit=100 safe |
| Rate limit | error_type: "rate_limit" |
π Metrics Explained
- Health Score: overdue/open <15% = π’
- Planner Insights: Top overdue + balance suggestions
- Capacity: members vs open cards ratio
π Security (ClawHub Approved)
β
read scope ONLY
β
api.trello.com exclusively
β
No persistence/file I/O
β
No token logging/output
β
12s timeout
β
package.json registry aligned
ClawHub v1.0.8 | tomas-mikula | FrontendAccelerator.com
Related skills
- Downloads
- 1.5kAll time
- Security audit
- Review
- Last updated
- 6mo ago
- Current version
- v1.0.8
- License
- MIT-0
