---
title: Trello
description: Gestiona tableros y tarjetas de Trello
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="trello"
  color="#0052CC"
/>

{/* MANUAL-CONTENT-START:intro */}
[Trello](https://trello.com) es una herramienta de colaboración visual que te ayuda a organizar proyectos, tareas y flujos de trabajo utilizando tableros, listas y tarjetas.

Con Trello en Sim, puedes:

- **Listar tableros y listas**: Ver los tableros a los que tienes acceso y sus listas asociadas.
- **Listar y buscar tarjetas**: Obtener todas las tarjetas en un tablero o filtrar por lista para ver su contenido y estado.
- **Crear tarjetas**: Añadir nuevas tarjetas a una lista de Trello, incluyendo descripciones, etiquetas y fechas de vencimiento.
- **Actualizar y mover tarjetas**: Editar propiedades de tarjetas, mover tarjetas entre listas y establecer fechas de vencimiento o etiquetas.
- **Obtener actividad reciente**: Recuperar acciones e historial de actividad para tableros y tarjetas.
- **Comentar en tarjetas**: Añadir comentarios a las tarjetas para colaboración y seguimiento.

La integración de Trello con Sim permite a tus agentes gestionar programáticamente las tareas, tableros y proyectos de tu equipo. Automatiza flujos de trabajo de gestión de proyectos, mantén listas de tareas actualizadas, sincroniza con otras herramientas o activa flujos de trabajo inteligentes en respuesta a eventos de Trello, todo a través de tus agentes de IA.
{/* MANUAL-CONTENT-END */}

## Instrucciones de uso

Integra con Trello para gestionar tableros y tarjetas. Lista tableros, lista tarjetas, crea tarjetas, actualiza tarjetas, obtiene acciones y añade comentarios.

## Herramientas

### `trello_list_lists`

Listar todas las listas en un tablero de Trello

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `boardId` | string | Sí | ID del tablero del que listar las listas |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Si la operación fue exitosa |
| `lists` | array | Array de objetos de lista con id, nombre, cerrado, posición e idTablero |
| `count` | number | Número de listas devueltas |
| `error` | string | Mensaje de error si la operación falló |

### `trello_list_cards`

Listar todas las listas en un tablero de Trello

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `boardId` | string | Sí | ID del tablero del que listar las listas |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Si la operación fue exitosa |
| `cards` | array | Array de objetos de tarjeta con id, nombre, desc, url, IDs de tablero/lista, etiquetas y fecha de vencimiento |
| `count` | number | Número de tarjetas devueltas |
| `error` | string | Mensaje de error si la operación falló |

### `trello_create_card`

Crear una nueva tarjeta en un tablero de Trello

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `boardId` | string | Sí | ID del tablero en el que crear la tarjeta |
| `listId` | string | Sí | ID de la lista en la que crear la tarjeta |
| `name` | string | Sí | Nombre/título de la tarjeta |
| `desc` | string | No | Descripción de la tarjeta |
| `pos` | string | No | Posición de la tarjeta \(top, bottom, o número flotante positivo\) |
| `due` | string | No | Fecha de vencimiento \(formato ISO 8601\) |
| `labels` | string | No | Lista de IDs de etiquetas separados por comas |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Si la tarjeta se creó correctamente |
| `card` | object | El objeto de la tarjeta creada con id, nombre, descripción, url y otras propiedades |
| `error` | string | Mensaje de error si la operación falló |

### `trello_update_card`

Actualizar una tarjeta existente en Trello

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `cardId` | string | Sí | ID de la tarjeta a actualizar |
| `name` | string | No | Nuevo nombre/título de la tarjeta |
| `desc` | string | No | Nueva descripción de la tarjeta |
| `closed` | boolean | No | Archivar/cerrar la tarjeta \(true\) o reabrirla \(false\) |
| `idList` | string | No | Mover tarjeta a una lista diferente |
| `due` | string | No | Fecha de vencimiento \(formato ISO 8601\) |
| `dueComplete` | boolean | No | Marcar la fecha de vencimiento como completada |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Si la tarjeta se actualizó correctamente |
| `card` | object | El objeto de la tarjeta actualizada con id, nombre, descripción, url y otras propiedades |
| `error` | string | Mensaje de error si la operación falló |

### `trello_get_actions`

Obtener actividad/acciones de un tablero o tarjeta

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `boardId` | string | No | ID del tablero del que obtener acciones \(se requiere boardId o cardId\) |
| `cardId` | string | No | ID de la tarjeta de la que obtener acciones \(se requiere boardId o cardId\) |
| `filter` | string | No | Filtrar acciones por tipo \(p.ej., "commentCard,updateCard,createCard" o "all"\) |
| `limit` | number | No | Número máximo de acciones a devolver \(predeterminado: 50, máx: 1000\) |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Si la operación fue exitosa |
| `actions` | array | Array de objetos de acción con tipo, fecha, miembro y datos |
| `count` | number | Número de acciones devueltas |
| `error` | string | Mensaje de error si la operación falló |

### `trello_add_comment`

Añadir un comentario a una tarjeta de Trello

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `cardId` | string | Sí | ID de la tarjeta en la que comentar |
| `text` | string | Sí | Texto del comentario |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Si el comentario se añadió correctamente |
| `comment` | object | El objeto de comentario creado con id, texto, fecha y miembro creador |
| `error` | string | Mensaje de error si la operación falló |

## Notas

- Categoría: `tools`
- Tipo: `trello`
