Orkesflow MCP Server

El servidor Orkesflow MCP permite integrar tus herramientas de IA (como Claude Desktop) directamente con tu plataforma Orkesflow. Podrás gestionar tareas, tableros y registros de tiempo utilizando lenguaje natural a través del protocolo MCP (Model Context Protocol).

Características

• 📋 Listar tareas: Obtén una visión general de tus tareas pendientes.
• 🏗️ Gestión de tableros: Explora los espacios y tableros disponibles.
• ➕ Creación de tareas: Crea nuevas tarjetas especificando título, prioridad, etiquetas y tablero (por ID o nombre).
• 🔄 Actualización de tareas: Modifica estados, mueve tareas entre columnas o cambia prioridades.
• ⏱️ Registro de tiempo: Añade registros de tiempo y costes a tareas específicas.

Requisitos Previos

1. Token de Acceso Personal (PAT): Necesitas un token generado desde tu perfil en Orkesflow con los permisos adecuados.
2. Node.js: Versión 18 o superior.

Instalación y Ejecución

Puedes ejecutar el servidor directamente usando npx sin necesidad de instalación global:

npx @orkesflow/mcp-server

Configuración en Claude Desktop

Para usar Orkesflow con Claude Desktop, añade la siguiente configuración en tu archivo claude_desktop_config.json:

macOS

~/Library/Application Support/Claude/claude_desktop_config.json

Windows

%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "orkesflow": {
      "command": "npx",
      "args": ["-y", "@orkesflow/mcp-server"],
      "env": {
        "ORKESFLOW_TOKEN": "TU_TOKEN_DE_ACCESO_AQUÍ",
        "ORKESFLOW_API_URL": "https://api.orkesflow.com"
      }
    }
  }
}

Herramientas Disponibles (Tools)

list_tasks

Recupera la lista de tareas del usuario.

list_boards

Lista todos los espacios y tableros a los que tienes acceso.

create_task

Crea una nueva tarea. Argumentos:

• title (requerido)
• boardName o boardId (opcional)
• priority (URGENT, HIGH, MEDIUM, LOW, NONE)
• labels (array de nombres)

update_task

Actualiza una tarea existente. Permite mover tareas usando columnName.

add_time_log

Registra minutos trabajados en una tarea.

Desarrollo

Si deseas contribuir o ejecutar el servidor localmente:

1. Clona el repositorio.
2. Instala dependencias: pnpm install.
3. Compila el proyecto: pnpm run build.
4. Ejecuta: ORKESFLOW_TOKEN=tu_token node dist/index.js.

© 2026 Orkesflow Team.