Monday.com MCP — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

Ler boards, grupos, itens, valores de colunas e atualizações
Criar e atualizar itens com escrita consciente de colunas
Descoberta de workspace + board para comportamento mais seguro do agente
Subitens suportados
Acesso a webhook + log de atividade para trilhas de auditoria

Demo ao vivo

Como fica na prática

monday-mcp.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "monday-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mondaydotcomorg/monday-api-mcp"
      ]
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "monday-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mondaydotcomorg/monday-api-mcp"
      ]
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "monday-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mondaydotcomorg/monday-api-mcp"
      ]
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "monday-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mondaydotcomorg/monday-api-mcp"
      ]
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "monday-mcp",
      "command": "npx",
      "args": [
        "-y",
        "@mondaydotcomorg/monday-api-mcp"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "monday-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@mondaydotcomorg/monday-api-mcp"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add monday-mcp -- npx -y @mondaydotcomorg/monday-api-mcp

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: Monday.com MCP

Consolidar o status do projeto em múltiplos boards do Monday

👤 PMs, líderes de time com projetos em múltiplos boards ⏱ ~15 min beginner

Quando usar: Hora do resumo de sexta e você tem 5 boards para varrer.

Pré-requisitos

Token de API do Monday — Perfil → Developer → API → token API v2; defina a variável de ambiente MONDAY_API_TOKEN

Fluxo

Descobrir o escopo

Use monday-mcp. List my workspaces and the boards in 'Engineering' workspace.✓ Copiado

→ Lista de workspace + boards
Buscar itens ativos por board

For each engineering board, list items in 'Working on it' and 'Stuck' status with owner + due date.✓ Copiado

→ Lista agrupada por board
Compor o resumo

Write a Friday rollup: shipped this week, in flight, blocked. 6 bullets total.✓ Copiado

→ Resumo conciso pronto para colar

Resultado: Snapshot cross-board em 5 minutos em vez de 45.

Armadilhas

Nomes de colunas de status diferem entre boards — Peça ao Claude para normalizar rótulos de status (Stuck/Blocked → bloqueado); documente o mapeamento no prompt

Combine com: google-workspace-mcp

Criar itens automaticamente a partir de dados de formulários ou e-mails de entrada

👤 Times de ops e processos orientados a intake ⏱ ~30 min intermediate

Quando usar: Clientes enviam formulários/e-mails e você cria itens no Monday manualmente.

Fluxo

Analisar a fonte

Use google-workspace-mcp + monday-mcp. Read unread emails labeled 'intake', extract structured fields.✓ Copiado

→ JSON por e-mail com campos extraídos
Criar itens

For each, create an item on board 'Customer requests' with the right group + column values.✓ Copiado

→ N itens criados com permalinks; flags de informações faltando listadas
Responder / confirmar

Reply to each sender with the item link as ack.✓ Copiado

→ Respostas automáticas enviadas

Resultado: Intake tratado em minutos; todos recebem confirmação.

Armadilhas

Intenção do remetente ambígua; item acaba no board errado — Se a confiança for baixa, encaminhe para um grupo de triagem em vez de adivinhar o board correto

Combine com: google-workspace-mcp

Limpar itens obsoletos em um board

👤 Líderes de projeto cansados de cards zumbi ⏱ ~25 min intermediate

Quando usar: Higiene trimestral em um board de longa duração.

Fluxo

Identificar os obsoletos

Use monday-mcp. List items on board 'Roadmap Q1' with no updates in 60+ days, grouped by owner.✓ Copiado

→ Lista de obsoletos por responsável
Redigir mensagens para os responsáveis

Draft one Monday update per stale item, pinging the owner with: 'Still active? Move to done or archive.'✓ Copiado

→ Rascunhos de atualizações prontos
Publicar + arquivar em massa após período de carência

Post the updates. After 7 days, anything still untouched gets moved to 'archive' group.✓ Copiado

→ Atualizações publicadas; entrada no calendário definida para o ciclo de limpeza

Resultado: Um board que reflete a realidade, não aspirações históricas.

Armadilhas

Arquivar itens em que alguém está trabalhando ativamente mas não atualizou — Sempre avise primeiro; período de carência antes do arquivamento automatizado

Combinações

Combine com outros MCPs para 10× de alavancagem

monday-mcp + google-workspace-mcp

Intake por e-mail; confirmação por e-mail; digest de status em um Doc

From the 'intake' Gmail label, create Monday items, reply with the item link, and append a daily digest to a Google Doc.✓ Copiado

monday-mcp + github

Sincronizar itens de engenharia do Monday com issues do GitHub

When a Monday item moves to 'In review', add a GitHub issue link if missing; when GitHub issue closes, set Monday status to Done.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
list_boards	workspace_id?	Sempre antes de escrever — descoberta de escopo	1 chamada GraphQL
get_board	board_id	Antes de criar itens — conheça os tipos de coluna	1 chamada
search_items	board_id, filters	Filtrar itens para fluxos de leitura	1 chamada (paginada)
create_item	board_id, group_id, name, column_values	Intake / novo trabalho	1 chamada
update_item_columns	item_id, column_values	Mudanças de status / responsável / data	1 chamada
create_update	item_id, body	Comentar em um item	1 chamada

Custo e limites

O que custa rodar

Cota de API: Orçamento de complexidade GraphQL do Monday — queries grandes custam mais que as simples
Tokens por chamada: Boards com muitas colunas/itens são pesados em tokens; prefira conjuntos de colunas mais estreitos
Monetário: Tier gratuito suporta API; Pro+ para orçamentos de complexidade maiores
Dica: Busque apenas as colunas que precisa (item.column_values[id IN [...]]); evite select-all em boards com 50+ colunas

Segurança

Permissões, segredos, alcance

Escopos mínimos: boards:read boards:write (apenas se escritas forem necessárias)

Armazenamento de credenciais: Variável de ambiente MONDAY_API_TOKEN

Saída de dados: Apenas para api.monday.com

Nunca conceda: Token de admin a um agente controlado por chat — use um token limitado por app

Itens podem conter dados sensíveis de clientes — cuidado com o que você deixa o Claude mover para saída do chat / logs

Solução de problemas

Erros comuns e correções

Orçamento de complexidade excedido

Reduza colunas/itens por query; percorra com paginação em vez de uma chamada grande

Verificar: Erro inclui a palavra 'complexity'

Tipo de coluna errado na criação

Leia o columns_schema do board primeiro; column_values deve ser JSON serializado por tipo

401 / token inválido

Regenere o token de API em Perfil → Developer; tokens têm escopo de usuário

Verificar: curl -X POST https://api.monday.com/v2 -H 'Authorization: $MONDAY_API_TOKEN' -d 'query{me{name}}'

Subitem não aparece sob o pai

Subitens vivem em um board separado; use o id do board de subitens, não o do pai

Alternativas

Monday.com MCP vs. outros

Alternativa	Quando usar	Troca
Linear MCP	Time de engenharia usando Linear, não Monday	Produto diferente; mapeamentos entre os dois são imperfeitos
Notion MCP	Seu rastreamento de trabalho vive em databases do Notion	Tipos de coluna do Notion são diferentes; semântica de status menos explícita

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills