Monday.com

Servidor MCP de Monday.com

Servidor MCP para monday.com, que permite a los clientes MCP interactuar con tableros, elementos, actualizaciones y documentos de Monday.com.

Componentes

Herramientas

El servidor implementa las siguientes herramientas:

• monday-create-item: Crea un nuevo elemento o subelemento en un tablero de Monday.com
• monday-get-board-groups: Recupera todos los grupos de un tablero especificado de Monday.com
• monday-create-update: Crea un comentario/actualización en un elemento de Monday.com
• monday-list-boards: Lista todos los tableros disponibles de Monday.com
• monday-list-items-in-groups: Lista todos los elementos en los grupos especificados de un tablero de Monday.com
• monday-list-subitems-in-items: Lista todos los subelementos de los elementos dados de Monday.com
• monday-create-board: Crea un nuevo tablero de Monday.com
• monday-create-board-group: Crea un nuevo grupo en un tablero de Monday.com
• monday-move-item-to-group: Mueve un elemento de Monday.com a un grupo diferente
• monday-delete-item: Elimina un elemento de Monday.com
• monday-archive-item: Archiva un elemento de Monday.com
• monday-get-item-updates: Recupera actualizaciones/comentarios para un elemento específico
• monday-get-docs: Lista documentos en Monday.com, opcionalmente filtrados por carpeta
• monday-get-doc-content: Recupera el contenido de un documento específico
• monday-create-doc: Crea un nuevo documento en Monday.com
• monday-add-doc-block: Agrega un bloque a un documento existente

Configuración

1. Cree y guarde un token de API personal en Monday.com siguiendo las instrucciones aquí.
2. Obtenga el nombre del espacio de trabajo desde la URL de su espacio de trabajo de Monday.com. Por ejemplo, si la URL es https://myworkspace.monday.com/, el nombre del espacio de trabajo es myworkspace.

Inicio rápido

Uso con Rube

1. Vaya a (Rube.app)[https://rube.app/]
2. Instale Rube en su cliente preferido, incluyendo Cursor, Claude, VS Code, Windsurf, etc.
3. Complete la autenticación con Rube
4. Ahora puede ejecutar acciones en Monday.com, como crear elementos, publicar actualizaciones, mover elementos

Instalación

Claude Desktop

En MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json

En Windows: %APPDATA%/Claude/claude_desktop_config.json

Usando uvx

"mcpServers": {
  "monday": {
    "command": "uvx",
    "args": [
      "mcp-server-monday"
    ],
    "env": {
      "MONDAY_API_KEY": "your-monday-api-key",
      "MONDAY_WORKSPACE_NAME": "your-monday-workspace-name"
    }
  }
}

Usando Docker

"mcpServers": {
  "monday-docker": {
    "command": "docker",
    "args": [
      "run", 
      "--rm", 
      "-i", 
      "-e",
      "MONDAY_API_KEY=your-monday-api-key",
      "-e",
      "MONDAY_WORKSPACE_NAME=your-monday-workspace-name",
      "sakce/mcp-server-monday"
    ]
  }
}

Desarrollo

Construcción y publicación

Para preparar el paquete para distribución:

1. Sincronice las dependencias y actualice el archivo de bloqueo:

uv sync

2. Construya las distribuciones del paquete:

uv build

Esto creará distribuciones de origen y rueda en el directorio dist/.

3. Publique en PyPI:

uv publish

Nota: Necesitará configurar credenciales de PyPI mediante variables de entorno o banderas de comando:

• Token: --token o UV_PUBLISH_TOKEN
• O nombre de usuario/contraseña: --username/UV_PUBLISH_USERNAME y --password/UV_PUBLISH_PASSWORD

Depuración

Dado que los servidores MCP se ejecutan a través de stdio, la depuración puede ser desafiante. Para la mejor experiencia de depuración, recomendamos encarecidamente usar el Inspector MCP.

Puede lanzar el Inspector MCP a través de npm con este comando:

npx @modelcontextprotocol/inspector uv run mcp-server-monday

Al iniciarse, el Inspector mostrará una URL que puede acceder en su navegador para comenzar a depurar.