monday.com MCP — Casos de uso, Instalar & Demo en vivo

Por qué usarlo

Características clave

CRUD de tablero, grupo, elemento, columna y subelemento
Publica actualizaciones (comentarios) en elementos para mantener un registro de auditoría
Filtra elementos por valores de columna para informes
Crea webhooks (si necesitas enviar datos a Claude)
Gestiona el JSON de valores de columna peculiar de monday para que no tengas que hacerlo

Demo en vivo

Cómo se ve en la práctica

monday.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "monday": {
      "command": "npx",
      "args": [
        "-y",
        "@mondaydotcomorg/monday-api-mcp"
      ]
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "monday": {
      "command": "npx",
      "args": [
        "-y",
        "@mondaydotcomorg/monday-api-mcp"
      ]
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "monday": {
      "command": "npx",
      "args": [
        "-y",
        "@mondaydotcomorg/monday-api-mcp"
      ]
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "monday": {
      "command": "npx",
      "args": [
        "-y",
        "@mondaydotcomorg/monday-api-mcp"
      ]
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "monday",
      "command": "npx",
      "args": [
        "-y",
        "@mondaydotcomorg/monday-api-mcp"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "monday": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@mondaydotcomorg/monday-api-mcp"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add monday -- npx -y @mondaydotcomorg/monday-api-mcp

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: monday.com

Genera automáticamente un resumen diario de standup a partir de un tablero de proyecto

👤 Líderes de equipo que ejecutan standups en monday.com ⏱ ~15 min beginner

Cuándo usarlo: Quieres saber 'qué cambió ayer, qué está bloqueado, qué vence hoy' sin desplazarte manualmente por el tablero.

Requisitos previos

Token API de monday — monday.com → avatar → Developers → My Access Tokens
ID de tablero — La URL contiene /boards/<board_id>

Flujo

Extrae elementos actualizados en las últimas 24 horas

Lista elementos en el tablero <id> donde updated_at > yesterday. Muestra nombre, estado, propietario, fecha de vencimiento.✓ Copiado

→ Lista de actividad reciente
Segmenta por estado

Agrupa estos por valor de columna de estado: Done / Working / Stuck / To Do. Muestra conteos y quién es el propietario de cada elemento Stuck.✓ Copiado

→ Resumen claro de 4 grupos
Formatea el standup

Formatea un standup de 10 líneas: moved-to-Done (conteo), started-Working (conteo), elementos Stuck con menciones de propietario @, elementos que vencen hoy.✓ Copiado

→ Resumen copiable

Resultado: Un resumen de standup que puedes pegar en Slack o LINE en 30 segundos.

Errores comunes

Filtrar por updated_at incluye cambios de valor de columna Y actualizaciones de subelementos — ruidoso — Agrega una consulta activity_logs filtrada solo a cambios de estado o propietario

Combinar con: line-bot · ms-teams

Importa 500 elementos en un tablero desde un CSV

👤 PMs iniciando un nuevo proyecto con tareas previamente listadas ⏱ ~25 min intermediate

Cuándo usarlo: Tienes una Hoja de Google / CSV de tareas y quieres que estén en un tablero de monday con las columnas correctas completadas.

Requisitos previos

CSV con columnas que coincidan con el tablero — Los nombres de encabezado deben coincidir aproximadamente con las columnas del tablero: name, status, owner_email, date

Flujo

Inspecciona el esquema del tablero de destino

Describe el tablero <id>: cada columna con su id, título, tipo y valores permitidos.✓ Copiado

→ Catálogo de columnas
Mapea CSV a column_values

Dado mis encabezados CSV [pega], produce un mapeo a ids de columna de monday. Marca cualquier fila CSV con estados no en el conjunto permitido.✓ Copiado

→ Mapeo + informe de validación
Crea elementos en lotes

Crea estos elementos en lotes de 25 con create_item + los column_values mapeados. Detente si 3 llamadas consecutivas fallan.✓ Copiado

→ Todos los itemIds; cualquier fallo listado con números de fila

Resultado: Los 500 elementos en el tablero con propietario, estado y fecha de vencimiento previamente completados.

Errores comunes

La forma JSON de column-value difiere por tipo de columna — fácil de enviar una carga inválida — Siempre obtén el tipo de columna primero; status usa {label:'...'}, date usa {date:'YYYY-MM-DD'}, people usa {personsAndTeams:[{id,kind}]}
Los límites de velocidad se activan en ~60 elementos/min — Duerme entre lotes; monday retorna 429 que el MCP muestra — agrega una pausa de 2s

Combinar con: filesystem

Publica una actualización de estado escrita por IA en cada elemento activo

👤 Ops/PMO que quieren contexto escrito en cada elemento en vuelo ⏱ ~30 min intermediate

Cuándo usarlo: Fin de semana — quieres que cada elemento 'Working on it' obtenga una actualización de estado de 2 líneas automáticamente.

Flujo

Encuentra elementos activos

Lista elementos en el tablero <id> donde status = 'Working on it'. Incluye nombre, propietario, texto de última actualización.✓ Copiado

→ Elementos en vuelo
Redacta una actualización de 2 líneas por elemento

Para cada elemento, redacta una actualización de estado de 2 oraciones basada en last_update + cambios recientes de columna. Usa un tono neutral.✓ Copiado

→ Borradores listos para revisión
Publica después de aprobación

Muéstrame borradores de 3 en 3. En mi 'ok', publica como una actualización en el elemento.✓ Copiado

→ Actualizaciones publicadas; itemIds confirmados

Resultado: Cada elemento activo ahora tiene una nota fresca de fin de semana, sin trabajo ocupado para el equipo.

Errores comunes

Publicar automáticamente sin revisión puede avergonzarte (contexto incorrecto) — Siempre controla los posts detrás de un 'ok' humano durante al menos la primera semana

Combinar con: github

Genera un resumen de cartera ejecutiva en 10 tableros de proyecto

👤 Gerentes de programa / jefes de personal ⏱ ~30 min advanced

Cuándo usarlo: Revisión semanal de liderazgo: una diapositiva que resuma el estado de cada proyecto.

Flujo

Enumera la cartera

Lista tableros en la carpeta 'Engineering / Projects'. Para cada uno, cuenta elementos por estado.✓ Copiado

→ Distribución de estado por tablero
Calcula una puntuación de salud

Para cada tablero: salud = 100 - 5*(elementos bloqueados) - 2*(elementos vencidos). Marca < 70 como rojo.✓ Copiado

→ Tablero → salud + color
Produce un informe de markdown

Genera una tabla de markdown de una pantalla: Board | Health | Stuck | Overdue | Top risk. Ordena por salud en orden ascendente.✓ Copiado

→ Tabla lista para liderazgo

Resultado: Un panel de cartera de un vistazo, repetible semanalmente.

Errores comunes

Los significados de 'Stuck' y 'overdue' varían en tableros — Estandariza columnas de estado o mantén anulaciones por tablero en un archivo de configuración

Combinar con: notion

Encuentra y archiva elementos obsoletos en un tablero

👤 Propietarios de tablero cansados de cruft ⏱ ~25 min intermediate

Cuándo usarlo: El tablero ha crecido a 1000+ elementos con muchos sin tocar durante meses.

Flujo

Encuentra elementos sin tocar

Elementos en el tablero <id> no actualizados en 90+ días y status != Done. Lista nombre, propietario, fecha de última actualización.✓ Copiado

→ Lista obsoleta
Decide por elemento

Muestra la lista de 10 en 10. Para cada uno: keep / archive / reassign. Diré una letra por elemento.✓ Copiado

→ Decisiones de clasificación
Ejecuta archivo/movimiento

Aplica: archiva los elementos 'a' con archive_item, reasigna elementos 'r' al propietario <me>, mantén 'k'.✓ Copiado

→ Tablero limpio; registro de cambios guardado

Resultado: Un tablero que refleja la realidad, con un registro de auditoría de lo que se archivó y por qué.

Errores comunes

Los elementos archivados son invisibles; difícil de restaurar si te arrepientes más tarde — Duplica primero el tablero como una instantánea, O usa etiquetas en lugar de archivo para una ejecución de prueba

Crea un elemento de incidente con artefactos vinculados después de una página de Sentry

👤 Ingenieros de guardia ⏱ ~15 min intermediate

Cuándo usarlo: Incidente recién cerrado; quieres un elemento de monday capturando alcance, cronología y propietarios.

Flujo

Recopila los artefactos

De Sentry, obtén issue <id>: título, primero visto, usuarios afectados, lanzamiento resolvente. De GitHub, el PR que lo arregló.✓ Copiado

→ Paquete de artefacto
Crea el elemento de monday

En el tablero 'Incidents', create_item con name='<Sentry title>', status='Resolved', owner=me, date=today, description=postmortem escrito automáticamente incluendo enlaces de artefacto.✓ Copiado

→ itemId devuelto
Publica la cronología como una actualización

Publica una actualización de cronología en ese elemento: hora de detección, despliegue revertido en, causa raíz, seguimientos.✓ Copiado

→ Actualización publicada

Resultado: Un elemento de postmortem creado dentro de 5 minutos del cierre del incidente, con todo vinculado.

Errores comunes

Una descripción demasiado larga rompe el formato de monday — Mantén la descripción en titulares; pon detalles en una actualización enumerada

Combinar con: sentry · github

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

monday + sentry

Crea automáticamente un elemento de incidente de monday cuando se activa un problema crítico de Sentry

Cuando el problema de Sentry WEB-3a91 alcanza 100+ eventos, crea un elemento en el tablero 'Incidents' con name=issue title y severity column configurada a P1.✓ Copiado

monday + github

Vincula una fusión de PR a un cambio de estado de elemento de monday

Cuando PR #342 se fusiona, encuentra el elemento de monday que coincida con su título y establece status a 'Done'.✓ Copiado

monday + notion

Resumen de cartera ejecutiva semanal publicado en Notion

Ejecuta el resumen de salud de cartera y crea una página de Notion con el resultado como tabla.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
list_boards	workspace_id?, limit?	Descubre tableros	Unidades de complejidad de GraphQL
get_board	board_id	Inspecciona el esquema antes de escribir	complejidad
list_items	board_id, limit?, cursor?, columns_filter?	Obtención de elementos paginados	complejidad
create_item	board_id, group_id?, name, column_values?	Agrega una nueva tarea	complejidad
change_column_value	board_id, item_id, column_id, value	Actualiza estado, propietario, fecha, etc.	complejidad
create_update	item_id, body	Publica un comentario en un elemento	complejidad
archive_item	item_id	Elimina sin borrar	complejidad
create_webhook	board_id, url, event	Envía cambios a un sistema externo	complejidad

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Límites de presupuesto de complejidad: 10M complejidad/minuto en Pro; 5M en Standard. Las consultas pesadas cuestan más.
Tokens por llamada: Lecturas de elementos: 500–2000 tokens. Esquema de tablero: 500–1500 tokens.
Monetario: La API es gratuita en tu nivel de plan. Los planes de monday comienzan en ~$9/usuario/mes.
Consejo: Usa el filtro columns en list_items para devolver solo los campos que necesitas — evita alcanzar el límite de complejidad en tableros anchos.

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: me:read boards:read

Almacenamiento de credenciales: MONDAY_API_TOKEN (token personal) en env

Salida de datos: Todas las llamadas a api.monday.com

No conceder nunca: account:admin para un MCP que solo lee tableros específicos

Los tokens personales heredan TUS permisos en cada tablero que puedas ver — establece permisos de forma estricta.
Usa la aplicación OAuth con ámbitos solicitados cuando distribuyas esto a usuarios finales.

Resolución de problemas

Errores comunes y soluciones

401 No autenticado

MONDAY_API_TOKEN falta/caducado. Regenera en monday.com → Developers → My Access Tokens.

Verificar: curl -H 'Authorization: $MONDAY_API_TOKEN' https://api.monday.com/v2 -d '{"query":"{ me { name } }"}''

ComplexityException — Complejidad máxima alcanzada

Consulta demasiado pesada. Reduce limit u obtén menos columnas/subelementos por elemento.

ColumnValueException — valor de columna inválido

La forma JSON de column-value es incorrecta para el tipo de columna. Obtén la columna primero e inspecciona el tipo, luego construye el JSON en consecuencia (status: {label}, date: {date:'YYYY-MM-DD'}).

Límite de velocidad excedido (429)

Retrocede a ~1 escritura/seg. monday aplica restricciones por minuto en mutaciones.

Alternativas

monday.com vs otros

Alternativa	Cuándo usarla	Contrapartida
Linear MCP	Los equipos enfocados en ingeniería quieren seguimiento de problemas primero por teclado	Menos flexible que monday; sin tipos de columna arbitrarios
Asana MCP	El equipo está en Asana	Modelo de columna/campo diferente
Notion MCP	Quieres documentos + seguimiento ligero en una superficie	Más débil en la gestión densa de proyectos; no es una herramienta PM real

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills