Trello Integration

Pro v1.0.0

Manage Trello boards, lists, and cards via REST API. Create cards, update statuses, add comments, and automate project management workflows.

Requires Claude Code CLI

This skill integrates with Trello through Claude Code. Install Claude Code and add this skill to use it.

Available Actions

List Boards

List all boards accessible to the authenticated user

Returns

array List of boards with id and name

Try saying...

  • "Show me all my Trello boards"
  • "List all boards"
  • "What boards do I have access to?"

Get Board Details

Get detailed information about a specific board

Parameters

Name Type Required Description
board_id string Required The ID of the board

Returns

object Board details including name, description, lists, and members

Try saying...

  • "Get details for board 60a1b2c3d4e5f6g7h8i9j0k1"
  • "Show me information about this board"
  • "What's in board XYZ?"

List Lists

List all lists (columns) in a board

Parameters

Name Type Required Description
board_id string Required The ID of the board

Returns

array List of lists with id and name

Try saying...

  • "Show me all lists in this board"
  • "What are the columns in board XYZ?"
  • "List all lists in my project board"

List Cards

List all cards in a specific list

Parameters

Name Type Required Description
list_id string Required The ID of the list

Returns

array List of cards with id, name, and description

Try saying...

  • "Show me all cards in the To Do list"
  • "What cards are in list XYZ?"
  • "List all tasks in the In Progress column"

Create Card

Create a new card in a list

Parameters

Name Type Required Description
list_id string Required The ID of the list where the card will be created
name string Required The name/title of the card
description string Optional Optional description for the card

Returns

object The created card with id, name, url, and other details

Try saying...

  • "Create a card called 'Review PR #123' in the Code Review list"
  • "Add a new task 'Update documentation'"
  • "Create a card with description"

Update Card

Update a card's properties (name, description, list, etc)

Parameters

Name Type Required Description
card_id string Required The ID of the card to update
field string Required The field to update (name, desc, idList, closed, etc)
value string Required The new value for the field

Returns

object The updated card

Try saying...

  • "Move card to the Done list"
  • "Update the card name to 'Completed Review'"
  • "Archive this card"

Add Comment

Add a comment to a card

Parameters

Name Type Required Description
card_id string Required The ID of the card
comment string Required The comment text

Returns

object The created comment action

Try saying...

  • "Add a comment 'Looks good!' to this card"
  • "Comment on card XYZ with status update"
  • "Leave a note on the card"

Search

Search across all boards, cards, and members

Parameters

Name Type Required Description
query string Required The search query

Returns

object Search results containing matching cards, boards, and members

Try saying...

  • "Search for all cards mentioning 'database migration'"
  • "Find cards about API changes"
  • "Search for 'urgent' across all boards"

Getting Started

API Key Moderate Setup
  1. 1 Go to https://trello.com/power-ups/admin
  2. 2 Create a new Power-Up or select an existing one
  3. 3 Navigate to the API Key tab and generate an API key
  4. 4 Click the Token link and authorize to generate a token
  5. 5 Add both to shell config: export TRELLO_API_KEY='...' and export TRELLO_API_TOKEN='...'
  6. 6 Restart terminal or run: source ~/.zshrc

Verify Setup

source ~/.config/claude-skills/trello-api/.venv/bin/activate && python scripts/client.py list-boards

Success: Lists your Trello boards without errors

Security & Access

Access Scope

Full access to all boards, lists, and cards visible to the authenticated Trello account. Can read, create, update, and delete content. Can modify board settings and add members.

  • The API token grants full access to your entire Trello account
  • Never share your API token - treat it like a password
  • Tokens can be revoked at https://trello.com/my/account if compromised
  • Consider using tokens with limited expiration (1day, 30days) instead of 'never'
  • The API key can be public, but the token must remain secret

Limitations

  • Action queries limited to 1,000 results per request
  • Use pagination with 'before' and 'since' parameters for large datasets
  • Webhooks recommended over polling for real-time updates

Get This Skill

Requires Pro subscription ($9/month)

Quick Reference

Type
REST API
Auth
API Key
Setup
Moderate Setup
Tools Required
Bash
Python Dependencies
requests>=2.28.0

Have Feedback?

Help us improve this skill by sharing your ideas and suggestions.

Request Improvements