Servidor MCP de Trello | Awesome MCP Servers

Trello MCP

Un servidor de Model Context Protocol (MCP) que ofrece integración integral de Trello para cualquier cliente compatible con MCP, incluidos Claude Desktop, Claude Code, Gemini CLI y más. Este servidor permite a los asistentes de IA interactuar con tableros, tarjetas, listas y más de Trello mediante una conexión local segura.

Características

🔍 Búsqueda y Descubrimiento

Búsqueda universal: busca en todo el contenido de Trello (tableros, tarjetas, miembros, organizaciones)
Tableros del usuario: obtén todos los tableros accesibles para el usuario actual
Detalles del tablero: recupera información detallada sobre tableros, incluidas listas y tarjetas

📝 Gestión de Tarjetas

Crear tarjetas: añade nuevas tarjetas a cualquier lista con descripciones, fechas de vencimiento y asignaciones
Actualizar tarjetas: modifica propiedades de las tarjetas como nombre, descripción, fechas de vencimiento y estado
Mover tarjetas: transfiere tarjetas entre listas para actualizar el estado del flujo de trabajo
Obtener detalles de la tarjeta: recupera información completa de la tarjeta, incluidos miembros, etiquetas y listas de verificación

💬 Colaboración

Añadir comentarios: publica comentarios en las tarjetas para la comunicación del equipo
Gestión de miembros: visualiza miembros del tablero y detalles de los miembros
Historial de actividad: rastrea acciones y cambios en las tarjetas

📋 Organización

Gestión de listas: crea nuevas listas y obtén tarjetas dentro de listas específicas
Etiquetas: visualiza y gestiona etiquetas del tablero para categorización
Listas de verificación: accede a listas de verificación de tarjetas y sus elementos
Adjuntos: visualiza adjuntos de tarjetas y archivos vinculados

Instalación

Requisitos previos

Node.js 18+ instalado
Un cliente compatible con MCP (Claude Desktop, Claude Code, Gemini CLI, etc.)
Cuenta de Trello con credenciales de API

Pasos de configuración

Clonar el repositorio

git clone https://github.com/kocakli/trello-desktop-mcp.git
cd trello-desktop-mcp

Instalar dependencias
```
npm install
```
Compilar el proyecto
```
npm run build
```
Obtener credenciales de la API de Trello
- Visita https://trello.com/app-key
- Copia tu Clave de API
- Genera un Token (nunca expira, acceso de lectura/escritura)

Configura tu cliente MCP

Elige las instrucciones para tu cliente a continuación:

Claude Desktop

Edita tu archivo de configuración de Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Añade el servidor Trello MCP:

{
  "mcpServers": {
    "trello": {
      "command": "node",
      "args": ["/absolute/path/to/trello-desktop-mcp/dist/index.js"],
      "env": {
        "TRELLO_API_KEY": "your-api-key-here",
        "TRELLO_TOKEN": "your-token-here"
      }
    }
  }
}

Luego reinicia Claude Desktop.

Claude Code (CLI)

Añade el servidor usando la CLI de Claude Code:

claude mcp add trello -- node /absolute/path/to/trello-desktop-mcp/dist/index.js \
  -e TRELLO_API_KEY=your-api-key-here \
  -e TRELLO_TOKEN=your-token-here

O añádelo al .mcp.json de tu proyecto:

{
  "mcpServers": {
    "trello": {
      "command": "node",
      "args": ["/absolute/path/to/trello-desktop-mcp/dist/index.js"],
      "env": {
        "TRELLO_API_KEY": "your-api-key-here",
        "TRELLO_TOKEN": "your-token-here"
      }
    }
  }
}

Gemini CLI

Edita tu archivo de configuración de Gemini CLI en ~/.gemini/settings.json:

{
  "mcpServers": {
    "trello": {
      "command": "node",
      "args": ["/absolute/path/to/trello-desktop-mcp/dist/index.js"],
      "env": {
        "TRELLO_API_KEY": "your-api-key-here",
        "TRELLO_TOKEN": "your-token-here"
      }
    }
  }
}

Otros Clientes MCP

Cualquier cliente compatible con MCP que admita transporte stdio puede usar este servidor. Debes configurarlo para:

Ejecutar node /absolute/path/to/trello-desktop-mcp/dist/index.js
Establecer las variables de entorno TRELLO_API_KEY y TRELLO_TOKEN

Consulta la documentación de tu cliente para conocer el formato de configuración exacto.

Reinicia tu cliente MCP para aplicar la nueva configuración.

Herramientas Disponibles

El servidor MCP proporciona 19 herramientas organizadas en tres fases:

Fase 1: Herramientas Esenciales

trello_search - Búsqueda universal en todo el contenido de Trello
trello_get_user_boards - Obtén todos los tableros accesibles para el usuario actual
get_board_details - Obtén información detallada del tablero con listas y tarjetas
get_card - Obtén detalles completos de la tarjeta
create_card - Crea nuevas tarjetas en cualquier lista

Fase 2: Operaciones Básicas

update_card - Actualiza propiedades de las tarjetas
move_card - Mueve tarjetas entre listas
trello_add_comment - Añade comentarios a las tarjetas
trello_get_list_cards - Obtén todas las tarjetas de una lista específica
trello_create_list - Crea nuevas listas en tableros

Fase 3: Funciones Avanzadas

trello_get_board_cards - Obtén todas las tarjetas de un tablero con filtrado
trello_get_card_actions - Obtén el historial de actividad de la tarjeta
trello_get_card_attachments - Obtén adjuntos de la tarjeta
trello_get_card_checklists - Obtén listas de verificación de la tarjeta
trello_get_board_members - Obtén miembros del tablero
trello_get_board_labels - Obtén etiquetas del tablero
trello_get_member - Obtén detalles de los miembros

Herramientas Heredadas (Compatibilidad inversa)

list_boards - Lista los tableros del usuario
get_lists - Obtén listas de un tablero

Ejemplos de Uso

Una vez configurado, puedes usar lenguaje natural con tu asistente de IA para interactuar con Trello:

"Show me all my Trello boards"
"Create a new card called 'Update documentation' in the To Do list"
"Move card X from In Progress to Done"
"Add a comment to card Y saying 'This is ready for review'"
"Search for all cards with 'bug' in the title"
"Show me all cards assigned to me"

Arquitectura

Protocolo MCP

El servidor implementa el Model Context Protocol (MCP), que proporciona:

Descubrimiento e invocación estandarizados de herramientas
Validación de parámetros con seguridad de tipos
Manejo estructurado de errores
Gestión automática de credenciales

Seguridad

Las credenciales de la API se almacenan localmente en la configuración de tu cliente MCP
No se transmiten credenciales por la red
Todas las llamadas a la API de Trello usan HTTPS
Se respeta la limitación de velocidad con lógica de reintento automático

Stack Técnico

TypeScript para seguridad de tipos
MCP SDK para la implementación del protocolo
Zod para validación de esquemas
Fetch API para peticiones HTTP

Desarrollo

Estructura del Proyecto

├── src/
│   ├── index.ts          # Main MCP server entry point
│   ├── server.ts         # Alternative server implementation
│   ├── tools/            # Tool implementations
│   │   ├── boards.ts     # Board-related tools
│   │   ├── cards.ts      # Card-related tools
│   │   ├── lists.ts      # List-related tools
│   │   ├── members.ts    # Member-related tools
│   │   ├── search.ts     # Search functionality
│   │   └── advanced.ts   # Advanced features
│   ├── trello/           # Trello API client
│   │   └── client.ts     # API client with retry logic
│   ├── types/            # TypeScript type definitions
│   └── utils/            # Utility functions
├── dist/                 # Compiled JavaScript
└── package.json          # Project configuration

Compilación desde el Código Fuente

# Install dependencies
npm install

# Build the project
npm run build

# Run type checking
npm run type-check

Pruebas

El servidor incluye manejo integral de errores y validación. Prueba tu configuración de la siguiente manera:

Verifica el estado de conexión de tu cliente MCP
Ejecuta un comando simple como "Muéstrame mis tableros de Trello"
Verifica que la respuesta incluya los datos de tu tablero

Solución de Problemas

Problemas Comunes

"No hay herramientas de Trello disponibles"
- Asegúrate de que tu cliente MCP se haya reiniciado por completo después de la configuración
- Comprueba que la ruta en la configuración apunte a dist/index.js
- Verifica que el archivo exista y esté compilado
"Credenciales no válidas"
- Vuelve a verificar tu clave de API y token
- Asegúrate de que el token tenga permisos de lectura/escritura
- Regenera el token si es necesario
"Límite de velocidad superado"
- El servidor incluye lógica de reintento automático
- Espera unos minutos si alcanzas los límites
- Considera reducir la frecuencia de las solicitudes

Registro de Depuración

Revisa los registros de tu cliente MCP para ver detalles de conexión y errores. Para Claude Desktop, los registros están en:

macOS: ~/Library/Logs/Claude/mcp-server-trello.log
Windows: %APPDATA%\Claude\Logs\mcp-server-trello.log

Contribuciones

¡Las contribuciones son bienvenidas! Por favor:

Haz un fork del repositorio
Crea una rama de características
Añade pruebas para la nueva funcionalidad
Envía una solicitud de extracción (pull request)

Licencia

Licencia MIT: consulta el archivo LICENSE para más detalles

Agradecimientos

Construido con el Model Context Protocol SDK
Usa la Trello REST API
Compatible con Claude Desktop, Claude Code, Gemini CLI y otros clientes MCP

Trello MCP

Documentación

Trello MCP

Características

🔍 Búsqueda y Descubrimiento

📝 Gestión de Tarjetas

💬 Colaboración

📋 Organización

Instalación

Requisitos previos

Pasos de configuración

Herramientas Disponibles

Fase 1: Herramientas Esenciales

Fase 2: Operaciones Básicas

Fase 3: Funciones Avanzadas

Herramientas Heredadas (Compatibilidad inversa)

Ejemplos de Uso

Arquitectura

Protocolo MCP

Seguridad

Stack Técnico

Desarrollo

Estructura del Proyecto

Compilación desde el Código Fuente

Pruebas

Solución de Problemas

Problemas Comunes

Registro de Depuración

Contribuciones

Licencia

Agradecimientos