Planka

Servidor MCP (Model Context Protocol) para integración completa con tableros Kanban de Planka. Permite gestionar proyectos, tableros, tarjetas, tareas y colaboración directamente desde aplicaciones MCP como Claude.

- Gestión de Proyectos: Crear, listar y administrar proyectos
- Tableros Kanban: Crear y gestionar tableros con listas personalizadas
- Gestión de Tarjetas: Crear, mover, duplicar y organizar tarjetas
- Sistema de Tareas: Crear subtareas y seguimiento de progreso
- Etiquetas y Categorías: Organizar tarjetas con etiquetas de colores
- Comentarios: Colaboración a través de comentarios en tarjetas
- Seguimiento de Tiempo: Cronómetros integrados para time tracking
- Gestión de Membresías: Control de acceso y permisos por tablero

Gestiona proyectos y tableros con operaciones CRUD completas.

- Parámetros:action,id,projectId,name,position,boardId

Administra listas dentro de los tableros.

- Parámetros:action,id,boardId,name,position

- Parámetros:action,id,listId,name,description,tasks

Control de cronómetros para seguimiento de tiempo.

- Parámetros:action,boardId,name,color,cardId,labelId

- Parámetros:action,cardId,name,tasks,isCompleted

Sistema de comentarios para colaboración.

Control de acceso y permisos por tablero.

- Parámetros:action,boardId,userId,role,canComment

Instalación General MCP EN LOCAL (NO RECOMENDADO)

cp config.example.env .env # Editar .env con la configuración de su servidor Planka

Configuración MCP en Aplicaciones USANDO NPX (RECOMENDADO)

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

Configuración básica con NPX (RECOMENDADO):

{ "mcpServers": { "planka": { "command": "npx", "args": ["@grec0/mcp-planka@latest"], "env": { "PLANKA_BASE_URL": "http://localhost:3000", "PLANKA_AGENT_EMAIL": "demo@demo.demo", "PLANKA_AGENT_PASSWORD": "demo" } } } }

⚠️ IMPORTANTE: Usar@latestgarantiza que se use la versión más reciente del paquete. Sin esto, puedes obtener errores como "no server info found".

{ "mcpServers": { "planka": { "command": "npx", "args": ["@grec0/mcp-planka@latest"], "env": { "PLANKA_BASE_URL": "https://tu-planka-server.com", "PLANKA_AGENT_EMAIL": "tu-email@ejemplo.com", "PLANKA_AGENT_PASSWORD": "tu-contraseña" } } } }

Para servidor Planka con certificado SSL autofirmado o interno:

{ "mcpServers": { "planka": { "command": "npx", "args": ["@grec0/mcp-planka@latest"], "env": { "PLANKA_BASE_URL": "https://planka-interno.empresa.com", "PLANKA_AGENT_EMAIL": "tu-email@ejemplo.com", "PLANKA_AGENT_PASSWORD": "tu-contraseña", "PLANKA_ALLOW_INSECURE": "true" } } } }

{ "mcpServers": { "planka": { "command": "node", "args": ["C:/ruta/a/kanban-mcp/dist/index.js"], "env": { "PLANKA_BASE_URL": "http://localhost:3000", "PLANKA_AGENT_EMAIL": "demo@demo.demo", "PLANKA_AGENT_PASSWORD": "demo" } } } }

{ "mcpServers": { "planka": { "command": "npm", "args": ["run", "dev"], "cwd": "C:/ruta/a/kanban-mcp", "env": { "PLANKA_BASE_URL": "http://localhost:3000", "PLANKA_AGENT_EMAIL": "demo@demo.demo", "PLANKA_AGENT_PASSWORD": "demo" } } } }

Después de configurar el MCP, puedes verificar que funciona correctamente:
- Reiniciar la aplicación(Claude Desktop, etc.)
- Probar operación básica:

mcp_kanban_project_board_manager(action: "get_projects", page: 1, perPage: 10)

mcp_kanban_project_board_manager(action: "create_board", projectId: "ID_DEL_PROYECTO", name: "Tablero de Prueba", position: 1)

// ❌ INCORRECTO "args": ["@grec0/mcp-planka"] // ✅ CORRECTO "args": ["@grec0/mcp-planka@latest"]

Variables de entorno faltantes o incorrectas:

"env": { "PLANKA_BASE_URL": "http://localhost:3000", "PLANKA_AGENT_EMAIL": "demo@demo.demo", "PLANKA_AGENT_PASSWORD": "demo" }

El servidor Planka no está ejecutándose:

- Verificar que Planka esté enhttp://localhost:3000
- Verificar que las credenciales sean correctas

npm cache clean --force npx @grec0/mcp-planka@latest

Error de certificado SSL (UNABLE_TO_VERIFY_LEAF_SIGNATURE)

Si obtiene errores relacionados con certificados SSL autofirmados o internos:

Error: unable to verify the first certificate Error: UNABLE_TO_VERIFY_LEAF_SIGNATURE

Solución: Habilitar conexiones inseguras agregandoPLANKA_ALLOW_INSECURE: "true"a la configuración:

"env": { "PLANKA_BASE_URL": "https://planka-interno.empresa.com", "PLANKA_AGENT_EMAIL": "tu-email@ejemplo.com", "PLANKA_AGENT_PASSWORD": "tu-contraseña", "PLANKA_ALLOW_INSECURE": "true" }

⚠️ ADVERTENCIA DE SEGURIDAD: Solo usarPLANKA_ALLOW_INSECURE=trueen entornos internos de confianza. Esta opción desactiva la validación de certificados SSL y no debe usarse para servidores públicos en Internet.

- Error de conexión: Verificar quePLANKA_BASE_URLsea correcta y accesible
- Error de autenticación: Verificar email y contraseña en las variables de entorno
- Timeout: Verificar conectividad de red con el servidor Planka

# Configuración básica PLANKA_BASE_URL=http://localhost:3000 PLANKA_AGENT_EMAIL=demo@demo.demo PLANKA_AGENT_PASSWORD=demo # Opcional: Para certificados SSL autofirmados o internos PLANKA_ALLOW_INSECURE=true

Si necesita un servidor Planka local para desarrollo:

# Usando Docker Compose docker-compose up -d # O usando NPM scripts del proyecto npm run up # Acceder a Planka # URL: http://localhost:3000 # Credenciales por defecto: demo@demo.demo / demo

# Iniciar contenedores Planka npm run up # Detener contenedores npm run down # Reiniciar contenedores npm run restart

// Listar proyectos mcp_kanban_project_board_manager({ action: "get_projects", page: 1, perPage: 10 }) // Crear tablero mcp_kanban_project_board_manager({ action: "create_board", projectId: "project_id", name: "Mi Nuevo Tablero", position: 1 })

// Crear tarjeta con tareas mcp_kanban_card_manager({ action: "create_with_tasks", listId: "list_id", name: "Nueva Funcionalidad", description: "Implementar nueva característica", tasks: ["Diseño", "Desarrollo", "Testing", "Deploy"], comment: "Tarjeta creada automáticamente" }) // Mover tarjeta entre listas mcp_kanban_card_manager({ action: "move", id: "card_id", listId: "new_list_id", position: 0 })

// Iniciar cronómetro mcp_kanban_stopwatch({ action: "start", id: "card_id" }) // Detener cronómetro mcp_kanban_stopwatch({ action: "stop", id: "card_id" })

- Verificar URL base: Asegúrese quePLANKA_BASE_URLsea correcta
- Verificar credenciales: Email y contraseña deben ser válidos
- Verificar conectividad: El servidor Planka debe estar ejecutándose

# Probar conectividad manualmente curl -X POST http://localhost:3000/api/access-tokens \ -H "Content-Type: application/json" \ -d '{"emailOrUsername": "demo@demo.demo", "password": "demo"}'

# Limpiar cache de NPX npx clear-npx-cache # O instalar globalmente npm install -g @grec0/mcp-planka

# Verificar variables de entorno echo $PLANKA_BASE_URL echo $PLANKA_AGENT_EMAIL # No mostrar password en logs por seguridad

- Verificar sintaxis JSONen el archivo de configuración
- Reiniciar la aplicacióndespués de cambios
- Verificar rutas absolutassi usa instalación local
- PLANKA_BASE_URLconfigurada correctamente
- PLANKA_AGENT_EMAILyPLANKA_AGENT_PASSWORDválidos
- Servidor Planka accesible desde la red

- Planka: v1.0.0+
- Node.js: >=18.0.0
- Sistemas: Windows, Linux, macOS
- MCP: Compatible con Claude Desktop y otros clientes MCP

- Autenticación basada en credenciales de Planka
- Comunicación a través de API REST estándar
- Variables de entorno para credenciales seguras
- Sin almacenamiento local de credenciales
- Fork el proyecto
- Crear branch para feature (git checkout -b feature/nueva-funcionalidad)
- Commit cambios (git commit -am 'Add nueva funcionalidad')
- Push al branch (git push origin feature/nueva-funcionalidad)
- Crear Pull Request

Este proyecto está licenciado bajo la Licencia MIT - ver el archivoLICENSEpara detalles.

- Issues:GitHub Issues
- Documentación:Wiki del Proyecto
- Planka:Documentación Oficial de Planka

Comprehensive Trello integration: 46 tools covering boards, cards, lists, labels, checklists, attachments, members, custom fields, and search. Read-only mode, image attachment auto-download. Active fork of kocakli/Trello-Desktop-MCP integrating contributions from across the Trello MCP fork ecosystem