monday.com MCP

Un marco abierto para conectar agentes de IA a tu sistema operativo de trabajo monday.com, brindándoles acceso seguro a datos y herramientas para tomar acción.

GitHub

427

Prueba este MCPPatrocinado

Servidor MCP alojado

npx add-mcp 'https://mcp.monday.com/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

🚀 monday.com MCP

Permite que los agentes de IA operen de manera confiable dentro de flujos de trabajo reales. Este MCP es el marco abierto de monday.com para conectar agentes a tu sistema operativo de trabajo, brindándoles acceso seguro a datos estructurados, herramientas para actuar y el contexto necesario para tomar decisiones inteligentes.

🌟 Descripción general

Este repositorio, mantenido por el equipo de IA de monday.com, proporciona un conjunto completo de herramientas para desarrolladores de agentes de IA que desean integrarse con monday.com. Ya sea que estés creando asistentes de IA, automatizaciones o integraciones personalizadas, nuestras herramientas facilitan la conexión con la plataforma monday.com.

👉 ¿Nuevo en monday MCP? Comienza aquí: monday.com/w/mcp

https://github.com/user-attachments/assets/ed8d24e1-256b-4f6b-9d84-38e54a8703fd

🔑 ¿Qué es monday.com?

monday.com es un sistema operativo de trabajo que impulsa a los equipos a gestionar procesos, proyectos y trabajo diario. Los equipos usan monday.com para planificar, hacer seguimiento y gestionar su trabajo en una plataforma centralizada. Proporciona una interfaz visual e intuitiva donde los equipos pueden:

Crear y gestionar proyectos con tableros personalizables
Hacer seguimiento de tareas a través de diferentes etapas con columnas de estado
Colaborar con miembros del equipo mediante actualizaciones y menciones
Automatizar flujos de trabajo e integrarse con otras herramientas
Visualizar datos con paneles e informes

📦 ¿Qué incluye?

💻 Servidor MCP de la API de monday

El paquete @mondaydotcomorg/monday-api-mcp proporciona una implementación de servidor plug-and-play para el Protocolo de Contexto de Modelo (MCP). Permite que los agentes de IA interactúen con la API de monday.com sin necesidad de crear integraciones complejas.

🤖 Kit de herramientas para agentes

El paquete @mondaydotcomorg/agent-toolkit proporciona un potente conjunto de herramientas y utilidades para construir agentes de IA que interactúen con la API de monday.com, compatible con implementaciones de OpenAI y del Protocolo de Contexto de Modelo (MCP).

🚀 Inicio rápido: MCP alojado (recomendado)

La forma más rápida, robusta y confiable de conectarse a monday.com. Nuestro servicio MCP alojado gestiona toda la infraestructura por ti: sin configuración local, actualizaciones automáticas y mejor rendimiento.

📚 Guías de integración

Comienza con tu plataforma de IA favorita:

Guía de inicio - ¿Es tu primera vez usando monday MCP?
Integración con Claude - Conéctate con Claude Desktop
Integración con Cursor - Integra con el IDE Cursor
Integración con ChatGPT - Conéctate con ChatGPT
Integración con MS Copilot - Integra con Microsoft Copilot Studio
Integración con Mistral - Conéctate con le Chat de Mistral AI
Indicaciones listas para usar - Ejemplos de indicaciones para comenzar

Configuración rápida con MCP alojado

Para Cursor

Simplemente agrega esto a tu configuración de MCP:

{
  "mcpServers": {
    "monday-mcp": {
      "url": "https://mcp.monday.com/mcp"
    }
  }
}

¿Por qué usar el MCP alojado?

✅ Sin instalación local - Funciona de inmediato sin configuración
✅ Actualizaciones automáticas - Siempre obtén las últimas funciones
✅ Mejor rendimiento - Infraestructura optimizada
✅ Autenticación OAuth - Gestión segura de tokens
✅ Controles de espacio de trabajo - Limita el acceso a espacios de trabajo específicos
✅ Mayor confiabilidad - Disponibilidad de nivel empresarial

Cuándo usar este repositorio en su lugar

Es posible que desees ejecutar el MCP localmente o usar el kit de herramientas para agentes si necesitas:

🔧 Personalizar el servidor MCP - Modificar el código fuente para necesidades específicas
🛠️ Construir agentes personalizados - Usar el kit de herramientas para agentes con OpenAI o implementaciones personalizadas
🔌 Trabajar sin conexión - Desarrollar sin conectividad a internet
🧪 Contribuir al desarrollo - Ayudar a mejorar el servidor MCP o el kit de herramientas

🏁 Guía de instalación local

Paso 1: Crea una cuenta en monday.com

Si aún no tienes una cuenta en monday.com:

Ve a monday.com y regístrate para crear una cuenta
Crea tu primer espacio de trabajo y tablero para comenzar

Paso 2: Genera un token de API

Para interactuar con la API de monday.com, necesitarás un token de API:

Inicia sesión en tu cuenta de monday.com
Haz clic en tu avatar en la esquina inferior izquierda
Selecciona "Developers"
Haz clic en "My access tokens" en el menú izquierdo
Copia tu token de acceso personal

Paso 3: Configura tu cliente MCP

Para Claude Desktop

Abre Claude Desktop
Ve a Configuración → Servidores MCP
Agrega un nuevo servidor con esta configuración:

{
  "mcpServers": {
    "monday-api-mcp": {
      "command": "npx",
      "args": [
        "@mondaydotcomorg/monday-api-mcp@latest"
      ],
      "env": {
        "MONDAY_TOKEN": "your_monday_api_token"
      }
    }
  }
}

Para Gemini CLI

Para comenzar con Gemini CLI, puedes usar la extensión oficial de Gemini CLI para monday.com.

La extensión de Gemini CLI incluye el servidor MCP de monday.com con un archivo de contexto y comandos personalizados que enseñan a Gemini cómo usar las herramientas de monday.com para flujos de trabajo potentes.

Para instalar la extensión, ejecuta el siguiente comando en tu terminal:

gemini extensions install https://github.com/mondaycom/mcp

Si prefieres usar el servidor MCP directamente sin la extensión, puedes agregarlo con este comando:

gemini mcp add -t http monday https://mcp.monday.com/mcp

Una vez que tengas la extensión instalada o el servidor MCP agregado, inicia Gemini CLI ejecutando:

gemini

Luego, autentícate con tu cuenta de monday.com ejecutando el siguiente comando dentro de Gemini CLI:

/mcp auth monday

Esto abrirá una ventana del navegador para completar el proceso de autenticación. Después de autenticarte, todas las herramientas de monday.com y los comandos personalizados estarán disponibles.

Algunos comandos personalizados para probar con la extensión:

/monday:create-item crear elemento en el tablero 123 para "Actualizar la interfaz de usuario"
/monday:sprint-summary resumen del sprint 853

Para Cursor u otros clientes MCP (configuración local)

Agrega a tu configuración:

{
  "mcpServers": {
    "monday-api-mcp": {
      "command": "npx",
      "args": [
        "@mondaydotcomorg/monday-api-mcp@latest"
      ],
      "env": {
        "MONDAY_TOKEN": "your_monday_api_token"
      }
    }
  }
}

Paso 5: Prueba tu integración

Haz una pregunta a Claude o a tu asistente de IA, por ejemplo:
- "¿Qué elementos tengo en el tablero 123?"
- "¿Puedes crear un tablero para gestionar mi proyecto?"
Tu asistente ahora debería poder interactuar con tu cuenta de monday.com.

⚙️ Configuración avanzada del MCP alojado

Uso de encabezados de autorización

Para especificar un encabezado de autorización personalizado y la versión de API con el MCP alojado:

{
  "mcpServers": {
    "monday-api-mcp-hosted": {
      "command": "npx",
      "args": [
        "-p",
        "node@20",
        "mcp-remote",
        "https://mcp.monday.com/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer <your_token>"
      }
    }
  }
}

Especificación de la versión de API

Puedes especificar la versión de API que deseas usar con el parámetro --header:

{
  "mcpServers": {
    "monday-api-mcp-hosted": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.monday.com/mcp",
        "--header",
        "Api-Version:${API_VERSION}"
      ],
      "env": {
        "API_VERSION": "2025-07"
      }
    }
  }
}

Instalación de la aplicación Monday MCP

Para autenticación OAuth y controles de espacio de trabajo, instala la aplicación Monday MCP desde el marketplace:

Visita la aplicación monday MCP en el marketplace
Haz clic en "Install" y sigue las instrucciones para agregarla a tu cuenta

🧰 Herramientas disponibles

Nuestro servidor MCP proporciona un rico conjunto de herramientas que brindan a los asistentes de IA la capacidad de interactuar con monday.com:

Categoría	Herramienta	Descripción
Operaciones de elementos	create_item	Crear un nuevo elemento en un tablero de monday.com con valores de columna especificados
	delete_item	Eliminar un elemento de un tablero de forma permanente
	get_board_items_by_name	Buscar elementos por ID de tablero y término/nombre
	create_update	Agregar una actualización/comentario a un elemento específico
	change_item_column_values	Modificar los valores de columna de un elemento existente
	move_item_to_group	Mover un elemento a un grupo diferente dentro del mismo tablero
Operaciones de tablero	create_board	Crear un nuevo tablero de monday.com con columnas especificadas
	get_board_schema	Recuperar la estructura de columnas y grupos de un tablero
	create_group	Crear un nuevo grupo en un tablero de monday.com
	create_column	Agregar una nueva columna a un tablero existente
	delete_column	Eliminar una columna de un tablero
Operaciones de cuenta	list_users_and_teams	Recuperar detalles de usuarios o equipos por ID, nombre o buscando en la cuenta
Operaciones de formularios	create_form	Crear un nuevo formulario de monday.com
	get_form	Obtener un formulario por su token

🎨 Herramientas del marco de aplicaciones de monday.com

¿Buscas crear aplicaciones personalizadas de monday.com con asistencia de IA? Las herramientas del marco de aplicaciones brindan a los agentes de IA acceso completo a la plataforma de desarrollo de aplicaciones de monday.com, lo que te permite crear, gestionar e implementar aplicaciones personalizadas directamente a través de asistentes de IA.

📖 Ver documentación completa de las herramientas del marco de aplicaciones

🔮 Herramientas dinámicas de API (Beta)

Nuestra función de herramientas dinámicas de API representa un avance significativo en cómo los agentes de IA pueden interactuar con monday.com. Si bien nuestras herramientas estándar cubren operaciones comunes, las herramientas dinámicas de API desbloquean todo el potencial de la API GraphQL de monday.com.

¿Qué son las herramientas dinámicas de API?

Las herramientas dinámicas de API brindan a los agentes de IA acceso completo y adaptable a toda la superficie de la API de monday.com. Esto significa que tu asistente de IA puede:

Acceder a cualquier endpoint de API - No solo a las operaciones predefinidas que hemos creado
Generar consultas GraphQL personalizadas - Crear exactamente la consulta necesaria para cualquier situación
Explorar dinámicamente el esquema de monday.com - Comprender todos los tipos de datos disponibles y sus relaciones

Herramientas dinámicas de API clave

Herramienta	Descripción
all_monday_api	Generar y ejecutar cualquier consulta o mutación GraphQL dinámicamente
get_graphql_schema	Obtener el esquema GraphQL de monday.com para comprender las operaciones disponibles
get_type_details	Recuperar información detallada sobre tipos GraphQL específicos

Posibilidades desbloqueadas

Con las herramientas dinámicas de API, tus asistentes de IA pueden:

Crear informes complejos que abarquen múltiples tableros, elementos y puntos de datos
Realizar operaciones por lotes en muchos elementos simultáneamente
Integrarse profundamente con funciones avanzadas de monday.com como documentos, espacios de trabajo y registros de actividad
Descubrir nuevas capacidades a medida que monday.com agrega funciones a su API

Cómo habilitarlas

Las herramientas dinámicas de API están en beta y deshabilitadas por defecto. Habilítalas con:

MONDAY_TOKEN=your_monday_api_token npx @mondaydotcomorg/monday-api-mcp@latest --enable-dynamic-api-tools true

También puedes usar el modo 'only' para habilitar exclusivamente las herramientas dinámicas de API:

MONDAY_TOKEN=your_monday_api_token npx @mondaydotcomorg/monday-api-mcp@latest --enable-dynamic-api-tools only

Cuando el modo 'only' está habilitado, el servidor proporcionará solo las herramientas dinámicas de API, filtrando todas las demás herramientas estándar. Esto es útil para usuarios avanzados que desean trabajar directamente con la API GraphQL.

⚠️ Nota: Las herramientas dinámicas de API requieren acceso completo a la API y no son compatibles con el modo de solo lectura.

🖥️ Configuración del servidor MCP

Argumento	Banderas	Descripción	Requerido	Predeterminado
Token de API de monday.com	`--token`, `-t`	Token de API de monday.com	Sí	-
Versión de API	`--version`, `-v`	Versión de API de monday.com	No	`current`
Modo	`--mode`, `-m`	Modo de herramienta: `default` para herramientas estándar de plataforma, `apps` para herramientas del marco de aplicaciones	No	`default`
Modo de solo lectura	`--read-only`, `-ro`	Habilitar modo de solo lectura	No	`false`
Herramientas dinámicas de API	`--enable-dynamic-api-tools`, `-edat`	Habilitar herramientas dinámicas de API	No	`false`

🔐 Autenticación y seguridad

El servidor requiere un token de API de monday.com para autenticarse con la API de monday.com. Puedes proporcionar este token de dos maneras:

Variable de entorno: MONDAY_TOKEN=your_monday_api_token
Argumento de línea de comandos: -t your_monday_api_token

Mejores prácticas de seguridad

Nunca compartas tu token de API en repositorios públicos o discusiones
Considera usar el modo de solo lectura (--read-only) cuando solo necesites recuperar datos
Rota regularmente tus tokens de API para mayor seguridad

📚 Casos de uso de ejemplo

Aquí hay algunos ejemplos de lo que puedes construir con nuestras herramientas:

1. Asistente de IA para gestión de proyectos

Crear y gestionar tareas en tableros de monday.com
Obtener actualizaciones sobre el estado del proyecto
Mover elementos entre grupos a medida que avanzan

2. Análisis de datos e informes

Extraer datos de tableros de monday.com
Generar informes y perspectivas
Crear nuevos tableros para informes

🌐 Comunidad y soporte

GitHub Issues: Para informes de errores y solicitudes de funciones
Discussions: Para preguntas y debates de la comunidad
Documentación para desarrolladores de monday.com: Aprende más sobre la API de monday.com

📚 Documentación

📋 Requisitos previos

Antes de usar estas herramientas, asegúrate de tener:

Node.js v20 o superior instalado
NPM v5.2.0 o superior instalado
Un token de API de monday.com

🛠️ Cómo desarrollar en el repositorio

Para desarrollar en el repositorio:

Clona el repositorio
Instala las dependencias: yarn install
Compila el proyecto: yarn build
Copia la ruta del archivo dist/index.js en el paquete monday-api-mcp.
Cambia la configuración para trabajar localmente

    "monday-api-mcp": {
      "command": "node",
      "args": [
        "<your_full_path_to_the_package>/dist/index.js",
        "--enable-dynamic-api-tools",
        "true"
      ],
      "env": {
        "MONDAY_TOKEN": "your_monday_api_token"
      }
    }

🤝 Contribuciones

¡Agradecemos las contribuciones de la comunidad! Ya sea corregir errores, mejorar la documentación o añadir nuevas funciones, tu ayuda es bienvenida.

Haz un fork del repositorio
Crea tu rama de funciones: git checkout -b feature/amazing-feature
Haz commit de tus cambios: git commit -m 'Add some amazing feature'
Sube los cambios a la rama: git push origin feature/amazing-feature
Abre un Pull Request

📄 Licencia

Este proyecto está bajo la Licencia MIT: consulta el archivo LICENSE para más detalles.

Se aclara que el servidor utiliza la API de monday.com, que está sujeta a los Términos para desarrolladores de monday.com.

Hecho con ❤️ por el equipo de IA de monday.com

monday.com | Plataforma para desarrolladores | GitHub