Skip to main content

Trello

Trello is a web-based project management and collaboration tool that allows individuals and teams to organize and track their tasks and projects. It provides a visual interface known as a “board” where users can create lists and cards to represent their tasks and activities.

The TrelloLoader allows you to load cards from a Trello board and is implemented on top of py-trello

This currently supports api_key/token only.

  1. Credentials generation: https://trello.com/power-ups/admin/

  2. Click in the manual token generation link to get the token.

To specify the API key and token you can either set the environment variables TRELLO_API_KEY and TRELLO_TOKEN or you can pass api_key and token directly into the from_credentials convenience constructor method.

This loader allows you to provide the board name to pull in the corresponding cards into Document objects.

Notice that the board “name” is also called “title” in oficial documentation:

https://support.atlassian.com/trello/docs/changing-a-boards-title-and-description/

You can also specify several load parameters to include / remove different fields both from the document page_content properties and metadata.

Features

  • Load cards from a Trello board.
  • Filter cards based on their status (open or closed).
  • Include card names, comments, and checklists in the loaded documents.
  • Customize the additional metadata fields to include in the document.

By default all card fields are included for the full text page_content and metadata accordinly.

%pip install --upgrade --quiet  py-trello beautifulsoup4 lxml
# If you have already set the API key and token using environment variables,
# you can skip this cell and comment out the `api_key` and `token` named arguments
# in the initialization steps below.
from getpass import getpass

API_KEY = getpass()
TOKEN = getpass()
········
········
from langchain_community.document_loaders import TrelloLoader

# Get the open cards from "Awesome Board"
loader = TrelloLoader.from_credentials(
"Awesome Board",
api_key=API_KEY,
token=TOKEN,
card_filter="open",
)
documents = loader.load()

print(documents[0].page_content)
print(documents[0].metadata)

API Reference:

Review Tech partner pages
Comments:
{'title': 'Review Tech partner pages', 'id': '6475357890dc8d17f73f2dcc', 'url': 'https://trello.com/c/b0OTZwkZ/1-review-tech-partner-pages', 'labels': ['Demand Marketing'], 'list': 'Done', 'closed': False, 'due_date': ''}
# Get all the cards from "Awesome Board" but only include the
# card list(column) as extra metadata.
loader = TrelloLoader.from_credentials(
"Awesome Board",
api_key=API_KEY,
token=TOKEN,
extra_metadata=("list"),
)
documents = loader.load()

print(documents[0].page_content)
print(documents[0].metadata)
Review Tech partner pages
Comments:
{'title': 'Review Tech partner pages', 'id': '6475357890dc8d17f73f2dcc', 'url': 'https://trello.com/c/b0OTZwkZ/1-review-tech-partner-pages', 'list': 'Done'}
# Get the cards from "Another Board" and exclude the card name,
# checklist and comments from the Document page_content text.
loader = TrelloLoader.from_credentials(
"test",
api_key=API_KEY,
token=TOKEN,
include_card_name=False,
include_checklist=False,
include_comments=False,
)
documents = loader.load()

print("Document: " + documents[0].page_content)
print(documents[0].metadata)

Help us out by providing feedback on this documentation page: