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

trello-planner

Installation