How to configure the Trello source

This guide walks you through setting up gtdhelper to show your Trello cards.

Prerequisites

Go to https://trello.com/power-ups/admin
Create a new Power-Up (or use an existing one)
Copy the API key
On the same page, click the link to generate a Token — authorize it when prompted

Create ~/.gtdhelper/trello.toml with the following content (or download the template):

api_key = "your-api-key"
token = "your-token"
member = "your-trello-username"

Restrict file permissions to protect your credentials:

chmod 600 ~/.gtdhelper/trello.toml

Add a boards list to limit which boards appear. Only cards from these boards will be shown. If boards is missing or empty, no cards are fetched.

boards = ["Product Board", "Engineering"]

Board names must match exactly (case-sensitive). You can find the board name in the board’s header on Trello.

Field	Value
`api_key`	The API key from step 1
`token`	The token generated in step 1
`member`	Your Trello username or member ID (visible in your profile URL: `trello.com/<username>`)

Restart gtdhelper (or wait for the next 5-minute refresh). Cards assigned to you should appear in the overlay, grouped by board name.

Check for errors in the gtdhelper logs if nothing shows up — common causes: