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