Trello MCP Server with Python

Integrations

  • Uses environment variables to securely store and access Trello API credentials required for authentication.

  • Provides comprehensive Trello board management capabilities including reading boards, manipulating lists (create, read, update, delete), and managing cards (create, read, update, delete) across Trello workspaces.

Servidor Trello MCP

Un potente servidor MCP para interactuar con tableros, listas y tarjetas de Trello a través de hosts de IA.

Tabla de contenido

Prerrequisitos

  1. Python 3.12 o superior, puede ser administrado fácilmente por uv
  2. Claude para escritorio instalado
  3. Credenciales de API y cuenta de Trello
  4. Gestor de paquetes uv instalado

Preinstalación

  1. Asegúrese de tener instalada la aplicación Claude Desktop
  2. Asegúrate de que ya hayas iniciado sesión con tu cuenta en Claude.
  3. Empezar Claude

Instalación

  1. Configurar las credenciales de la API de Trello:
    • Vaya a Administración de aplicaciones de Trello
    • Cree una nueva integración en Nuevo encendido o Integración
    • Complete su información (puede dejar vacía la URL del conector Iframe) y asegúrese de seleccionar el espacio de trabajo correcto
    • Haga clic en el ícono de su aplicación y navegue hasta "Clave API" desde la barra lateral izquierda.
    • Copia tu "clave API" y en el lado derecho: "puedes generar manualmente un Token". Haz clic en la palabra token para obtener tu Token de Trello.
  2. Crea un archivo .env.example en la raíz del proyecto con .env y configura las variables que acabas de obtener:
TRELLO_API_KEY=your_api_key_here TRELLO_TOKEN=your_token_here
  1. Instale uv si aún no lo ha hecho:
curl -LsSf https://astral.sh/uv/install.sh | sh
  1. Clonar este repositorio:
git clone https://github.com/m0xai/trello-mcp-server.git cd trello-mcp-server
  1. Instalar dependencias y configurar el servidor para Claude usando uv::
uv run mcp install main.py
  1. Reiniciar la aplicación Claude Desktop

Capacidades

OperaciónJuntaListaTarjeta
Leer
Escribir
Actualizar
Borrar

Capacidades detalladas

Operaciones de la Junta

  • ✅ Leer todos los tableros
  • ✅ Leer detalles específicos del tablero

Operaciones de lista

  • ✅ Leer todas las listas en un tablero
  • ✅ Leer detalles específicos de la lista
  • ✅ Crear nuevas listas
  • ✅ Actualizar el nombre de la lista
  • ✅ Archivar (eliminar) listas

Operaciones con tarjeta

  • ✅ Leer todas las tarjetas de una lista
  • ✅ Leer los detalles específicos de la tarjeta
  • ✅ Crea nuevas tarjetas
  • ✅ Actualizar los atributos de la tarjeta
  • ✅ Eliminar tarjetas

Uso

Una vez instalado, puedes interactuar con tus tableros de Trello a través de Claude. Aquí tienes algunos ejemplos de consultas:

  • "Muéstrame todas mis tablas"
  • "¿Qué listas hay en el tablero [board_name]?"
  • "Crear una nueva tarjeta en la lista [nombre_de_lista] con el título [título]"
  • "Actualizar la descripción de la tarjeta [card_name]"
  • Archivar la lista [nombre_de_lista]

Solución de problemas

Si encuentra problemas:

  1. Verifique sus credenciales de API de Trello en el archivo .env
  2. Comprueba que tienes los permisos adecuados en tu espacio de trabajo de Trello
  3. Asegúrese de que Claude for Desktop esté ejecutando la última versión
  4. Verifique los registros en busca de mensajes de error con el comando uv run mcp dev main.py
  5. Asegúrese de que uv esté correctamente instalado y en su PATH

Contribuyendo

¡No dudes en enviarnos problemas y solicitudes de mejora!

ID: z0jconf16h