---
title: Trello
icon: table-columns
description: Set up the Trello resource in Python.
---

## Dependencies

No additional dependencies - uses `aiohttp` (included).

For credential setup, see the [Trello Setup](/home/setup/trello) guide.

## Configuration

```python
import os

from mirage import MountMode, Workspace
from mirage.resource.trello import TrelloConfig, TrelloResource

config = TrelloConfig(
    api_key=os.environ["TRELLO_API_KEY"],
    api_token=os.environ["TRELLO_API_TOKEN"],
)
resource = TrelloResource(config=config)
ws = Workspace({"/trello/": resource}, mode=MountMode.READ)
```

## Config Reference

| Field          | Required | Description                                     |
| -------------- | -------- | ----------------------------------------------- |
| `api_key`      | Yes      | Trello API key                                  |
| `api_token`    | Yes      | Trello API token                                |
| `workspace_id` | No       | Restrict the mounted tree to a single workspace |
| `board_ids`    | No       | Restrict the mounted tree to specific boards    |
| `base_url`     | No       | REST endpoint, defaults to Trello Cloud         |
