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