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

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

Un servidor de protocolo de contexto de modelo que proporciona herramientas para interactuar con tableros de Trello, lo que permite una gestión fluida de tarjetas, listas y actividades al tiempo que maneja la limitación de velocidad y la seguridad de tipos.

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
ConnectWise Manage MCP Server
ethangillani
-
security
A
license
-
quality
A Model Context Protocol server that enables Claude to interact with the ConnectWise Manage API to perform operations like retrieving, creating, updating, and deleting tickets, companies, contacts, and other entities.
Last updated -
JavaScript
MIT License
Rember MCPofficial
rember
-
security
A
license
-
quality
A Model Context Protocol server that allows Claude to create flashcards for Rember, helping users study and remember information through spaced repetition reviews.
Last updated -
88
16
TypeScript
MIT License
NPM Sentinel MCP
Nekzus
A
security
A
license
A
quality
A Model Context Protocol server providing utility tools for development and testing, offering functionalities like personalized greetings, random card drawing, and datetime formatting with an extensible architecture.
Last updated -
19
464
2
TypeScript
MIT License

View all related MCP servers

Claude MCP Trello