Planka MCP Server

MCP Planka Server

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.

🚀 Características

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

📋 Herramientas Disponibles

`mcp_kanban_project_board_manager`

Gestiona proyectos y tableros con operaciones CRUD completas.

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

`mcp_kanban_list_manager`

Administra listas dentro de los tableros.

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

`mcp_kanban_card_manager`

Gestión completa de tarjetas Kanban.

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

`mcp_kanban_stopwatch`

Control de cronómetros para seguimiento de tiempo.

Parámetros: action, id

`mcp_kanban_label_manager`

Gestión de etiquetas y categorización.

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

`mcp_kanban_task_manager`

Control de tareas y subtareas.

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

`mcp_kanban_comment_manager`

Sistema de comentarios para colaboración.

Parámetros: action, cardId, text

`mcp_kanban_membership_manager`

Control de acceso y permisos por tablero.

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

🛠️ Instalación

Instalación General MCP EN LOCAL (NO RECOMENDADO)

Instalar dependencias:

npm install

Configurar variables de entorno:

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

Compilar:

npm run build

⚙️ Configuración

Variables de Entorno

Variable	Descripción	Por Defecto
`PLANKA_BASE_URL`	URL base del servidor Planka	`http://localhost:3000`
`PLANKA_AGENT_EMAIL`	Email para autenticación	-
`PLANKA_AGENT_PASSWORD`	Contraseña para autenticación	-

Configuración MCP en Aplicaciones USANDO NPX (RECOMENDADO)

Ubicación del archivo de configuración

Claude Desktop:

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

Para Claude Desktop (config.json)

Configuración básica con NPX:

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

Para servidor Planka remoto:

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

Para instalación local

{
  "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"
      }
    }
  }
}

Para entorno de desarrollo

{
  "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"
      }
    }
  }
}

Verificar configuración MCP

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)
Crear un tablero de prueba:
mcp_kanban_project_board_manager(action: "create_board", projectId: "ID_DEL_PROYECTO", name: "Tablero de Prueba", position: 1)

Variables de Entorno Principales

# Configuración básica
PLANKA_BASE_URL=http://localhost:3000
PLANKA_AGENT_EMAIL=demo@demo.demo
PLANKA_AGENT_PASSWORD=demo

Configuración de Servidor Planka Local

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

🚀 Uso

Iniciar el servidor (instalación local)

npm run start

Modo desarrollo

npm run dev

Con inspector MCP

npm run inspector

Scripts Docker (Para Planka local)

# Iniciar contenedores Planka
npm run up

# Detener contenedores
npm run down

# Reiniciar contenedores
npm run restart

📚 Ejemplos de Uso

Gestión de Proyectos

// 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
})

Gestión de Tarjetas

// 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
})

Seguimiento de Tiempo

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

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

🔧 Solución de Problemas

Error de Conexión con Planka

Si obtiene errores de conexión:

Verificar URL base: Asegúrese que PLANKA_BASE_URL sea 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"}'

Error NPX "Package not found"

Si NPX no encuentra el paquete:

# Limpiar cache de NPX
npx clear-npx-cache

# O instalar globalmente
npm install -g @grec0/mcp-planka

Problemas de Autenticación

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

Error de Configuración MCP

Verificar sintaxis JSON en el archivo de configuración
Reiniciar la aplicación después de cambios
Verificar rutas absolutas si usa instalación local

Variables de Entorno Faltantes

Verificar:

PLANKA_BASE_URL configurada correctamente
PLANKA_AGENT_EMAIL y PLANKA_AGENT_PASSWORD válidos
Servidor Planka accesible desde la red

🧪 Testing

npm test

📖 Compatibilidad

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

🔐 Seguridad

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

🤝 Contribución

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

📜 License

Este proyecto está licenciado bajo la Licencia MIT - ver el archivo LICENSE para detalles.

🆘 Support

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

Install Server

HTTP connection URL

security – no known vulnerabilities

license - not found

quality - confirmed to work

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

A Model Context Protocol server that enables AI assistants like Claude to interact directly with Planka Kanban boards, allowing automated management of projects, tasks, and workflows through conversational interfaces.

Related MCP Servers

MCP Python Toolbox
gianlucamazza
-
security
F
license
-
quality
A Model Context Protocol server that enables AI assistants like Claude to perform Python development tasks through file operations, code analysis, project management, and safe code execution.
Last updated -
1
Python
Solana Agent Kit MCP Server
sendaifun
-
security
A
license
-
quality
A Model Context Protocol server that enables Claude AI to interact with the Solana blockchain through a standardized interface, providing tools for transactions, account queries, and wallet management.
Last updated -
219
79
Apache 2.0
Hass-MCP
voska
-
security
A
license
-
quality
A Model Context Protocol server that enables AI assistants like Claude to interact directly with Home Assistant, allowing them to query device states, control smart home entities, and perform automation tasks.
Last updated -
104
Python
MIT License
Solana Agent Kit MCP Server
cryptoleek-team
-
security
F
license
-
quality
A Model Context Protocol server that provides onchain tools for Claude AI, allowing it to interact with the Solana blockchain through a standardized interface for operations like managing assets, executing token operations, and retrieving network information.
Last updated -
6
TypeScript

View all related MCP servers