Claude 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, a la vez que gestiona automáticamente la limitación de velocidad, la seguridad de tipos y la gestión de errores.

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

Herramientas disponibles

`trello_get_cards_by_list`

Recupera una lista de tarjetas contenidas en el ID de lista especificado.

{
  name: "trello_get_cards_by_list",
  arguments: {
    listId: string; // Trello list ID
  }
}

`trello_get_lists`

Recupera todas las listas del tablero.

{
  name: "trello_get_lists",
  arguments: {}
}

`trello_get_recent_activity`

Recupera la actividad más reciente del tablero. El argumento limit puede especificar cuántas se recuperarán (predeterminado: 10).

{
  name: "trello_get_recent_activity",
  arguments: {
    limit?: number; // Optional: number of activities to retrieve
  }
}

`trello_add_card`

Agrega una tarjeta a la lista especificada.

{
  name: "trello_add_card",
  arguments: {
    listId: string;       // The ID of the list to add to
    name: string;         // The title of the card
    description?: string; // Optional: details of the card
    dueDate?: string;     // Optional: due date (e.g., ISO8601)
    labels?: string[];    // Optional: array of label IDs
  }
}

`trello_update_card`

Actualiza el contenido de una tarjeta.

{
  name: "trello_update_card",
  arguments: {
    cardId: string;       // The ID of the card to be updated
    name?: string;        // Optional: updated title
    description?: string; // Optional: updated description
    dueDate?: string;     // Optional: updated due date (e.g., ISO8601)
    labels?: string[];    // Optional: updated array of label IDs
  }
}

`trello_archive_card`

Archiva (cierra) la tarjeta especificada.

{
  name: "trello_archive_card",
  arguments: {
    cardId: string; // The ID of the card to archive
  }
}

`trello_add_list`

Agrega una nueva lista al tablero.

{
  name: "trello_add_list",
  arguments: {
    name: string; // Name of the new list
  }
}

`trello_archive_list`

Archiva (cierra) la lista especificada.

{
  name: "trello_archive_list",
  arguments: {
    listId: string; // The ID of the list to archive
  }
}

`trello_get_my_cards`

Recupera todas las tarjetas relacionadas con tu cuenta.

{
  name: "trello_get_my_cards",
  arguments: {}
}

`trello_search_all_boards`

Realiza una búsqueda entre todos los tableros del espacio de trabajo (organización), según el plan o los permisos.

{
  name: "trello_search_all_boards",
  arguments: {
    query: string;   // Search keyword
    limit?: number;  // Optional: max number of results (default: 10)
  }
}

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/hrs-asano/claude-mcp-trello.git cd claude-mcp-trello
Instalar dependencias:

npm install

Construir el proyecto:

npm run build

Ejecución de pruebas

npm test

Integración con Claude Desktop

Para integrar este servidor MCP con Claude Desktop, agregue la siguiente configuración a su archivo ~/Library/Application\ Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "trello": {
      "command": "{YOUR_NODE_PATH}", // for example: /opt/homebrew/bin/node
      "args": [
        "{YOUR_PATH}/claude-mcp-trello/build/index.js"
      ],
      "env": {
        "TRELLO_API_KEY": "{YOUR_KEY}",
        "TRELLO_TOKEN": "{YOUR_TOKEN}",
        "TRELLO_BOARD_ID": "{YOUR_BOARD_ID}"
      }
    }
  }
}

Asegúrese de reemplazar {YOUR_NODE_PATH}, {YOUR_PATH}, {YOUR_KEY}, {YOUR_TOKEN} y {YOUR_BOARD_ID} con los valores adecuados para su entorno.

Contribuyendo

¡Agradecemos sus contribuciones! Lea nuestra Guía de Contribución para obtener más información sobre nuestro código de conducta y el proceso para enviar solicitudes de incorporación de cambios.

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

Claude MCP Trello

Integrations

Claude MCP Trello

Características

Herramientas disponibles

`trello_get_cards_by_list`

`trello_get_lists`

`trello_get_recent_activity`

`trello_add_card`

`trello_update_card`

`trello_archive_card`

`trello_add_list`

`trello_archive_list`

`trello_get_my_cards`

`trello_search_all_boards`

Limitación de velocidad

Manejo de errores

Desarrollo

Prerrequisitos

Configuración

Ejecución de pruebas

Integración con Claude Desktop

Contribuyendo

Licencia

Expresiones de gratitud

Tools

Related Resources

Appeared in Searches