Servidor MCP Trello

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona herramientas para interactuar con los tableros de Trello. Este servidor permite una integración fluida con la API de Trello, gestionando automáticamente la limitación de velocidad, la seguridad de tipos y la gestión de errores.

Registro de cambios

0.3.0

Se agregaron capacidades de gestión de tablero y espacio de trabajo:
- list_boards - Lista todos los tableros a los que el usuario tiene acceso
- set_active_board - Establece el tablero activo para futuras operaciones
- list_workspaces - Enumera todos los espacios de trabajo a los que el usuario tiene acceso
- set_active_workspace - Establece el espacio de trabajo activo para futuras operaciones
- list_boards_in_workspace : enumera todos los tableros en un espacio de trabajo específico
- get_active_board_info - Obtener información sobre el tablero actualmente activo
Se agregó almacenamiento de configuración persistente para recordar el tablero/espacio de trabajo activo
Manejo de errores mejorado para todas las operaciones nuevas

0.2.1

Se agregaron comentarios JSDoc detallados a las funciones del limitador de velocidad.
Manejo de errores mejorado para la funcionalidad de adjuntar imágenes
Documentación actualizada para la herramienta adjuntar imagen a tarjeta

0.2.0

Se agregó la herramienta attach_image_to_card para adjuntar imágenes a tarjetas desde URL
Se agregó compatibilidad con Docker con compilación de múltiples etapas
Seguridad mejorada al mover las variables de entorno a .env
Se agregó la configuración de Docker Compose
Se agregó .env.template para una configuración más sencilla

0.1.1

Se agregó la herramienta move_card para mover tarjetas entre listas
Documentación mejorada

0.1.0

Versión inicial con funciones básicas de gestión de tableros de Trello

Características

Integración completa con el tablero de Trello : interactúa con tarjetas, listas y actividades del tablero
Limitación de velocidad incorporada : respeta los límites de la API de Trello (300 solicitudes/10 s por clave de API, 100 solicitudes/10 s por token)
Implementación de tipo seguro : escrita en TypeScript con definiciones de tipo completas
Validación de entrada : validación robusta para todas las entradas de API
Manejo de errores : Manejo de errores elegante con mensajes informativos
Selección dinámica de tableros : cambia entre tableros y espacios de trabajo sin reiniciar

Instalación

Instalación de Docker (recomendada)

La forma más sencilla de ejecutar el servidor es usando Docker:

Clonar el repositorio:

git clone https://github.com/delorenj/mcp-server-trello
cd mcp-server-trello

Copia la plantilla de entorno y completa tus credenciales de Trello:

cp .env.template .env

Construya y ejecute con Docker Compose:

docker compose up --build

Instalación mediante herrería

Para instalar Trello Server para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @modelcontextprotocol/mcp-server-trello --client claude

Instalación manual

npm install @delorenj/mcp-server-trello

Configuración

Variables de entorno

El servidor se puede configurar mediante variables de entorno. Cree un archivo .env en el directorio raíz con las siguientes variables:

# Required: Your Trello API credentials
TRELLO_API_KEY=your-api-key
TRELLO_TOKEN=your-token

# Required: Initial board ID (can be changed later using set_active_board)
TRELLO_BOARD_ID=your-board-id

# Optional: Initial workspace ID (can be changed later using set_active_workspace)
TRELLO_WORKSPACE_ID=your-workspace-id

Puedes obtener estos valores de:

Clave API: https://trello.com/app-key
Token: Generar usando su clave API
ID del tablero: se encuentra en la URL del tablero (por ejemplo, https://trello.com/b/BOARD\_ID/board-name )
ID del espacio de trabajo: se encuentra en la configuración del espacio de trabajo o mediante la herramienta list_workspaces

Gestión de tableros y espacios de trabajo

A partir de la versión 0.3.0, el servidor MCP admite la selección dinámica de tablero y espacio de trabajo:

El TRELLO_BOARD_ID en su archivo .env se utiliza como el ID del tablero inicial cuando se inicia el servidor
Puede cambiar el tablero activo en cualquier momento utilizando la herramienta set_active_board
El tablero seleccionado persiste entre reinicios del servidor (almacenado en ~/.trello-mcp/config.json )
De manera similar, puede configurar y conservar un espacio de trabajo activo utilizando set_active_workspace

Esto le permite trabajar con múltiples tableros y espacios de trabajo sin reiniciar el servidor ni cambiar las variables de entorno.

Ejemplo de flujo de trabajo

Comience enumerando los tableros disponibles:

{
  name: 'list_boards',
  arguments: {}
}

Configura tu tablero activo:

{
  name: 'set_active_board',
  arguments: {
    boardId: "abc123"  // ID from list_boards response
  }
}

Enumere los espacios de trabajo si es necesario:

{
  name: 'list_workspaces',
  arguments: {}
}

Establezca un espacio de trabajo activo si es necesario:

{
  name: 'set_active_workspace',
  arguments: {
    workspaceId: "xyz789"  // ID from list_workspaces response
  }
}

Consulte la información actual del tablero activo:

{
  name: 'get_active_board_info',
  arguments: {}
}

Herramientas disponibles

obtener_tarjetas_por_id_de_lista

Obtener todas las tarjetas de una lista específica.

{
  name: 'get_cards_by_list_id',
  arguments: {
    listId: string  // ID of the Trello list
  }
}

obtener_listas

Recuperar todas las listas del tablero actualmente activo.

{
  name: 'get_lists',
  arguments: {}
}

obtener_actividad_reciente

Obtener la actividad reciente en el tablero actualmente activo.

{
  name: 'get_recent_activity',
  arguments: {
    limit?: number  // Optional: Number of activities to fetch (default: 10)
  }
}

añadir tarjeta a la lista

Agregar una nueva tarjeta a una lista especificada.

{
  name: 'add_card_to_list',
  arguments: {
    listId: string,       // ID of the list to add the card to
    name: string,         // Name of the card
    description?: string, // Optional: Description of the card
    dueDate?: string,    // Optional: Due date (ISO 8601 format)
    labels?: string[]    // Optional: Array of label IDs
  }
}

actualizar_detalles_de_la_tarjeta

Actualizar los detalles de una tarjeta existente.

{
  name: 'update_card_details',
  arguments: {
    cardId: string,       // ID of the card to update
    name?: string,        // Optional: New name for the card
    description?: string, // Optional: New description
    dueDate?: string,    // Optional: New due date (ISO 8601 format)
    labels?: string[]    // Optional: New array of label IDs
  }
}

tarjeta de archivo

Envía una tarjeta al archivo.

{
  name: 'archive_card',
  arguments: {
    cardId: string  // ID of the card to archive
  }
}

añadir_lista_al_tablero

Añade una nueva lista al tablero actualmente activo.

{
  name: 'add_list_to_board',
  arguments: {
    name: string  // Name of the new list
  }
}

lista de archivo

Enviar una lista al archivo.

{
  name: 'archive_list',
  arguments: {
    listId: string  // ID of the list to archive
  }
}

obtener_mis_tarjetas

Obtener todas las tarjetas asignadas al usuario actual.

{
  name: 'get_my_cards',
  arguments: {}
}

mover_tarjeta

Mover una tarjeta a una lista diferente.

{
  name: 'move_card',
  arguments: {
    cardId: string,  // ID of the card to move
    listId: string   // ID of the target list
  }
}

adjuntar imagen a la tarjeta

Adjunte una imagen a una tarjeta directamente desde una URL.

{
  name: 'attach_image_to_card',
  arguments: {
    cardId: string,  // ID of the card to attach the image to
    imageUrl: string, // URL of the image to attach
    name?: string    // Optional: Name for the attachment (defaults to "Image Attachment")
  }
}

tableros de listas

Enumere todos los tableros a los que el usuario tiene acceso.

{
  name: 'list_boards',
  arguments: {}
}

establecer_tablero_activo

Establecer el tablero activo para futuras operaciones.

{
  name: 'set_active_board',
  arguments: {
    boardId: string  // ID of the board to set as active
  }
}

lista_espacios_de_trabajo

Enumere todos los espacios de trabajo a los que el usuario tiene acceso.

{
  name: 'list_workspaces',
  arguments: {}
}

establecer_espacio_de_trabajo_activo

Establecer el espacio de trabajo activo para operaciones futuras.

{
  name: 'set_active_workspace',
  arguments: {
    workspaceId: string  // ID of the workspace to set as active
  }
}

tableros de listas en el espacio de trabajo

Enumere todos los tableros en un espacio de trabajo específico.

{
  name: 'list_boards_in_workspace',
  arguments: {
    workspaceId: string  // ID of the workspace to list boards from
  }
}

obtener_información_del_tablero_activo

Obtenga información sobre el tablero actualmente activo.

{
  name: 'get_active_board_info',
  arguments: {}
}

Limitación de velocidad

El servidor implementa un algoritmo de depósito de tokens para limitar la velocidad para cumplir con los límites de la API de Trello:

300 solicitudes cada 10 segundos por clave API
100 solicitudes cada 10 segundos por token

La limitación de velocidad se gestiona de forma automática y las solicitudes se pondrán en cola si se alcanzan los límites.

Manejo de errores

El servidor proporciona mensajes de error detallados para varios escenarios:

Parámetros de entrada no válidos
Límite de velocidad excedido
Errores de autenticación de API
Problemas de red
Identificaciones de tablero/lista/tarjeta no válidas

Desarrollo

Prerrequisitos

Node.js 16 o superior
npm o hilo

Configuración

Clonar el repositorio

git clone https://github.com/delorenj/mcp-server-trello
cd mcp-server-trello

Instalar dependencias

npm install

Construir el proyecto

npm run build

Contribuyendo

¡Las contribuciones son bienvenidas!

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Expresiones de gratitud

Creado con el SDK del protocolo de contexto de modelo
Utiliza la API REST de Trello

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

Facilita la interacción con los tableros de Trello a través de la API de Trello, ofreciendo características como limitación de velocidad, seguridad de tipos, validación de entrada y manejo de errores para una gestión fluida de tarjetas, listas y actividades del tablero.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Trello MCP Server
andypost
A
security
F
license
A
quality
Enables interaction with Trello boards, lists, and cards through Model Context Protocol (MCP) tools, leveraging TypeScript for type safety and asynchronous operations.
Last updated -
5
JavaScript
Claude MCP Trello
hrs-asano
A
security
A
license
A
quality
A Model Context Protocol server that provides tools for interacting with Trello boards, enabling seamless management of cards, lists, and activities while handling rate limiting and type safety.
Last updated -
10
3
JavaScript
MIT License
trello-mcp-server
v4lheru
-
security
A
license
-
quality
Connects to Trello with all the tools available that I was able to find in API reference
Last updated -
3
1
TypeScript
MIT License
MCP Server Trello
diegofornalha
A
security
A
license
A
quality
Enables seamless integration with Trello boards, allowing users to manage cards, lists, and activities while automatically handling rate limiting and providing type safety.
Last updated -
9
TypeScript
MIT License

View all related MCP servers