Monday.com

Servidor MCP Monday.com

Servidor MCP para monday.com, permitindo que clientes MCP interajam com boards, itens, atualizações e documentos do Monday.com.

Componentes

Ferramentas

O servidor implementa as seguintes ferramentas:

• monday-create-item: Cria um novo item ou subitem em um board do Monday.com
• monday-get-board-groups: Recupera todos os grupos de um board especificado do Monday.com
• monday-create-update: Cria um comentário/atualização em um item do Monday.com
• monday-list-boards: Lista todos os boards disponíveis do Monday.com
• monday-list-items-in-groups: Lista todos os itens em grupos especificados de um board do Monday.com
• monday-list-subitems-in-items: Lista todos os subitens para itens fornecidos do Monday.com
• monday-create-board: Cria um novo board no Monday.com
• monday-create-board-group: Cria um novo grupo em um board do Monday.com
• monday-move-item-to-group: Move um item do Monday.com para um grupo diferente
• monday-delete-item: Exclui um item do Monday.com
• monday-archive-item: Arquiva um item do Monday.com
• monday-get-item-updates: Recupera atualizações/comentários para um item específico
• monday-get-docs: Lista documentos no Monday.com, opcionalmente filtrados por pasta
• monday-get-doc-content: Recupera o conteúdo de um documento específico
• monday-create-doc: Cria um novo documento no Monday.com
• monday-add-doc-block: Adiciona um bloco a um documento existente

Configuração

1. Crie e salve um Token de API pessoal no Monday.com seguindo as instruções aqui.
2. Obtenha o Nome do Workspace a partir da URL do seu workspace do Monday.com. Por exemplo, se a URL for https://myworkspace.monday.com/, o nome do workspace é myworkspace.

Início Rápido

Instalação

Claude Desktop

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

No 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 o Servidor MCP Monday.com para Claude Desktop automaticamente via Smithery:

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

Desenvolvimento

Compilação e Publicação

Para preparar o pacote para distribuição:

1. Sincronize as dependências e atualize o arquivo de bloqueio:

uv sync

2. Compile as distribuições do pacote:

uv build

Isso criará distribuições de origem e wheel no diretório dist/.

3. Publique no PyPI:

uv publish

Observação: Você precisará definir as credenciais do PyPI por meio de variáveis de ambiente ou sinalizadores de comando:

• Token: --token ou UV_PUBLISH_TOKEN
• Ou nome de usuário/senha: --username/UV_PUBLISH_USERNAME e --password/UV_PUBLISH_PASSWORD

Depuração

Como os servidores MCP são executados via stdio, a depuração pode ser desafiadora. Para a melhor experiência de depuração, recomendamos fortemente o uso do MCP Inspector.

Você pode iniciar o MCP Inspector via npm com este comando:

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

Ao iniciar, o Inspector exibirá uma URL que você pode acessar no seu navegador para começar a depurar.