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 de Monday.com especificado
• monday-create-update: Crea un comentario/actualización en un elemento de Monday.com
• monday-list-boards: Lista todos los tableros de Monday.com disponibles
• monday-list-items-in-groups: Lista todos los elementos en grupos especificados de un tablero de Monday.com
• monday-list-subitems-in-items: Lista todos los subelementos de elementos de Monday.com dados
• 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: Añade un bloque a un documento existente

Configuración

1. Crea y guarda un token de API personal en Monday.com siguiendo las instrucciones aquí.
2. Obtén el nombre del espacio de trabajo desde la URL de tu 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

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

Usando Smithery

Para instalar el Servidor MCP de Monday.com para Claude Desktop automáticamente a través de Smithery:

npx -y @smithery/cli install @sakce/mcp-server-monday --client claude

Desarrollo

Compilación y publicación

Para preparar el paquete para su distribución:

1. Sincroniza las dependencias y actualiza el archivo de bloqueo:

uv sync

2. Compila las distribuciones del paquete:

uv build

Esto creará distribuciones de código fuente y wheel en el directorio dist/.

3. Publica en PyPI:

uv publish

Nota: Necesitarás configurar las 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 sobre stdio, la depuración puede ser desafiante. Para la mejor experiencia de depuración, recomendamos encarecidamente usar el Inspector MCP.

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

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

Al lanzarlo, el Inspector mostrará una URL que puedes acceder en tu navegador para comenzar a depurar.