Skip to content

How to configure the Trello source

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

Prerequisites

  • A Trello account

Steps

1. Get your API credentials

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

2. Create the configuration file

cp scripts/config/trello.toml.example ~/.gtdhelper/trello.toml

Or create ~/.gtdhelper/trello.toml manually:

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

Restrict file permissions to protect your credentials:

chmod 600 ~/.gtdhelper/trello.toml

3. Choose which boards to show

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.

4. Fill in your credentials

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>)

5. Verify it works

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:

  • Wrong API key or token: double-check at https://trello.com/power-ups/admin
  • Wrong member name: check your profile URL at trello.com
  • No assigned cards: the script only fetches cards where you are a member

See also