Monday.com

Interaja com quadros, itens, atualizações e documentos do Monday.com.

GitHub
34

Documentação

Servidor MCP Monday.com

Servidor MCP para monday.com, permitindo que clientes MCP interajam com quadros, 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 quadro do Monday.com
  • monday-get-board-groups: Recupera todos os grupos de um quadro específico do Monday.com
  • monday-create-update: Cria um comentário/atualização em um item do Monday.com
  • monday-list-boards: Lista todos os quadros disponíveis do Monday.com
  • monday-list-items-in-groups: Lista todos os itens em grupos específicos de um quadro do Monday.com
  • monday-list-subitems-in-items: Lista todos os subitens para determinados itens do Monday.com
  • monday-create-board: Cria um novo quadro no Monday.com
  • monday-create-board-group: Cria um novo grupo em um quadro 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

Usando Rube

  1. Vá para (Rube.app)[https://rube.app/]
  2. Instale o Rube no seu cliente preferido, incluindo Cursor, Claude, VS Code, Windsurf etc.,
  3. Complete a autenticação com o Rube
  4. Agora você pode executar ações no Monday.com, como criar itens, postar atualizações, mover itens

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

Desenvolvimento

Compilação e Publicação

Para preparar o pacote para distribuição:

  1. Sincronize as dependências e atualize o lockfile:
uv sync
  1. Compile as distribuições do pacote:
uv build

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

  1. Publique no PyPI:
uv publish

Nota: Você precisará definir as credenciais do PyPI por meio de variáveis de ambiente ou flags 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 por meio de 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 depuração.