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