> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mypraxos.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Trello Integration
> Connect Praxos with Trello for project management
## Overview
Trello integration enables Praxos to manage boards, lists, and cards in your Trello workspace.
## Features
* Create and update boards
* Manage lists
* Create, move, and update cards
* Add comments and attachments
* Manage labels and due dates
* Add members to cards
* Checklist management
## Setup
### 1. Get API Credentials
1. Go to [Trello Power-Ups Admin Portal](https://trello.com/power-ups/admin)
2. Click "New" to create a new Power-Up
3. Note your API Key
### 2. Generate Token
1. Visit: `https://trello.com/1/authorize?expiration=never&name=Praxos&scope=read,write&response_type=token&key=YOUR_API_KEY`
2. Click "Allow"
3. Copy the token
### 3. Configure Praxos
Add to `.env`:
```bash theme={null}
TRELLO_API_KEY=your_api_key
TRELLO_TOKEN=your_token
```
## Usage Examples
### Board Management
**List Boards**
```
User: Show my Trello boards
Praxos: Your Trello boards:
1. Product Roadmap
2. Marketing Campaign
3. Personal Tasks
4. Team Goals Q4
```
**Create Board**
```
User: Create a Trello board called "New Project"
Praxos: ✓ Created board "New Project"
Default lists: To Do, In Progress, Done
[Open in Trello]
```
### Card Operations
**Create Card**
```
User: Add a card "Design mockups" to my Product Roadmap board
Praxos: ✓ Created card in "Product Roadmap"
List: To Do
[View Card] [Add details]
```
**Update Card**
```
User: Move "Design mockups" to In Progress
Praxos: ✓ Moved card to "In Progress" list
```
**Add Details**
```
User: Add a due date of next Friday to the Design mockups card
Praxos: ✓ Updated card:
Due date: Oct 15, 2024
Reminder: 24 hours before
```
### Comments and Activity
**Add Comment**
```
User: Comment on the Design mockups card: "Great progress!"
Praxos: ✓ Added comment to card
Author: You
Time: Just now
```
**View Activity**
```
User: What's the latest activity on the Product Roadmap board?
Praxos: Recent activity:
• Sarah moved "API Integration" to Done (5 min ago)
• Mike added checklist to "Testing" (1 hour ago)
• You created "Design mockups" (2 hours ago)
```
### Checklists
**Create Checklist**
```
User: Add a checklist to Design mockups card with 3 items:
- Research competitors
- Create wireframes
- Get feedback
Praxos: ✓ Created checklist "Tasks" with 3 items
Progress: 0/3 complete
```
**Update Checklist**
```
User: Mark "Research competitors" as complete
Praxos: ✓ Checked off item
Progress: 1/3 complete (33%)
```
### Labels
**Add Label**
```
User: Add "High Priority" label to Design mockups
Praxos: ✓ Added label "High Priority" (Red)
```
**Filter by Label**
```
User: Show all high priority cards in Product Roadmap
Praxos: High priority cards:
1. Design mockups (To Do)
2. User testing (In Progress)
3. Launch preparation (To Do)
```
## Configuration
### Environment Variables
```bash theme={null}
# Required
TRELLO_API_KEY=your_api_key
TRELLO_TOKEN=your_token
# Optional
TRELLO_DEFAULT_BOARD=board_id
TRELLO_WEBHOOK_CALLBACK=https://your-domain.com/trello/webhook
```
### Board Templates
Configure default board structure:
```python theme={null}
DEFAULT_LISTS = ["To Do", "In Progress", "Review", "Done"]
DEFAULT_LABELS = ["High Priority", "Low Priority", "Bug", "Feature"]
```
## Advanced Features
### Webhooks
Real-time notifications for:
* Card created/updated/moved
* Comments added
* Checklist items completed
* Members added/removed
Setup webhook:
```bash theme={null}
POST https://api.trello.com/1/tokens/{token}/webhooks/
{
"callbackURL": "https://your-domain.com/trello/webhook",
"idModel": "board_id"
}
```
### Bulk Operations
```
User: Move all cards in "To Do" list that are due today to "In Progress"
Praxos: Moving 3 cards...
✓ Moved "Design mockups"
✓ Moved "Write documentation"
✓ Moved "Code review"
```
### Card Templates
Create cards from templates:
```
User: Create a bug report card for "Login not working"
Praxos: ✓ Created bug report card:
Title: [BUG] Login not working
Checklist:
- Reproduce issue
- Identify root cause
- Create fix
- Test thoroughly
- Deploy
Labels: Bug, High Priority
```
## Trello Power-Ups
Enhance with Power-Ups:
* Calendar view
* Custom fields
* Card aging
* Voting
* Time tracking
## Troubleshooting
### Authentication Issues
**Invalid Token**
* Token may have expired (if not set to "never")
* Regenerate token
* Update `.env` file
**Insufficient Permissions**
* Verify token has read/write scope
* Check API key is valid
* Ensure user has board access
### Rate Limits
Trello rate limits:
* 100 requests per 10 seconds per token
* 300 requests per 10 seconds per API key
Praxos implements request queuing and automatic retry with backoff.
### Board Not Found
* Verify board ID is correct
* Check user has access to board
* Board may have been deleted or archived
## Best Practices
* Use clear, descriptive card titles
* Leverage labels for categorization
* Set due dates for time-sensitive tasks
* Use checklists to break down complex tasks
* Archive completed cards regularly
* Maintain consistent board structure
## Security
* API keys and tokens encrypted
* Per-user credential isolation
* Secure webhook validation
* Regular token rotation recommended
## Integration with Other Tools
Combine Trello with other integrations:
```
User: Create a Trello card for every email from boss@company.com
Praxos: ✓ Created automation:
New emails from boss@company.com →
New cards in "Boss Requests" list
```
```
User: When I mark a Trello card as done,
add it to my Notion "Completed Tasks" database
Praxos: ✓ Created automation:
Trello card moved to Done →
Entry added to Notion database
```
## Next Steps