monday.com MCP

npx add-mcp 'https://mcp.monday.com/mcp'

🌟 Visão Geral

Este repositório, mantido pelo time de IA da monday.com, fornece um conjunto abrangente de ferramentas para desenvolvedores de agentes de IA que desejam integrar com a monday.com. Se você está construindo assistentes de IA, automações ou integrações personalizadas, nossas ferramentas facilitam a conexão com a plataforma monday.com.

👉 Novo no monday MCP? Comece aqui: monday.com/w/mcp

https://github.com/user-attachments/assets/ed8d24e1-256b-4f6b-9d84-38e54a8703fd

🔑 O que é a monday.com?

A monday.com é um sistema operacional de trabalho que capacita equipes a executar processos, projetos e o trabalho do dia a dia. As equipes usam a monday.com para planejar, acompanhar e gerenciar seu trabalho em uma plataforma centralizada. Ela fornece uma interface visual e intuitiva onde as equipes podem:

• Criar e gerenciar projetos com quadros personalizáveis
• Acompanhar tarefas em diferentes estágios com colunas de status
• Colaborar com membros da equipe por meio de atualizações e menções
• Automatizar fluxos de trabalho e integrar com outras ferramentas
• Visualizar dados com painéis e relatórios

📦 O que está Incluso

💻 Servidor MCP da API monday

O pacote @mondaydotcomorg/monday-api-mcp fornece uma implementação de servidor plug-and-play para o Model Context Protocol (MCP). Ele permite que agentes de IA interajam com a API da monday.com sem precisar construir integrações complexas.

🤖 Kit de Ferramentas para Agentes

O pacote @mondaydotcomorg/agent-toolkit fornece um poderoso conjunto de ferramentas e utilitários para construir agentes de IA que interagem com a API da monday.com, suportando implementações OpenAI e Model Context Protocol (MCP).

🚀 Início Rápido: MCP Hospedado (Recomendado)

A maneira mais rápida, robusta e confiável de se conectar à monday.com. Nosso serviço MCP hospedado cuida de toda a infraestrutura para você - sem configuração local, atualizações automáticas e desempenho aprimorado.

📚 Guias de Integração

Comece com sua plataforma de IA favorita:

• Guia de Introdução - Primeira vez usando o monday MCP?
• Integração com Claude - Conecte-se com o Claude Desktop
• Integração com Cursor - Integre com a IDE Cursor
• Integração com ChatGPT - Conecte-se com o ChatGPT
• Integração com MS Copilot - Integre com o Microsoft Copilot Studio
• Integração com Mistral - Conecte-se com o le Chat da Mistral AI
• Prompts Prontos para Uso - Exemplos de prompts para começar

Configuração Rápida com MCP Hospedado

Para Cursor

Basta adicionar isto às suas configurações de MCP:

{
  "mcpServers": {
    "monday-mcp": {
      "url": "https://mcp.monday.com/mcp"
    }
  }
}

Por que Usar o MCP Hospedado?

• ✅ Sem instalação local - Funciona imediatamente sem configuração
• ✅ Atualizações automáticas - Sempre obtenha os recursos mais recentes
• ✅ Melhor desempenho - Infraestrutura otimizada
• ✅ Autenticação OAuth - Gerenciamento seguro de tokens
• ✅ Controles de workspace - Limite o acesso a workspaces específicos
• ✅ Maior confiabilidade - Disponibilidade de nível empresarial

Quando Usar Este Repositório

Você pode querer executar o MCP localmente ou usar o kit de ferramentas para agentes se precisar de:

• 🔧 Personalizar o servidor MCP - Modificar o código-fonte para necessidades específicas
• 🛠️ Construir agentes personalizados - Usar o kit de ferramentas para OpenAI ou implementações personalizadas
• 🔌 Trabalhar offline - Desenvolver sem conexão com a internet
• 🧪 Contribuir para o desenvolvimento - Ajudar a melhorar o servidor MCP ou o kit de ferramentas

🏁 Guia de Instalação Local

Passo 1: Crie uma Conta na monday.com

Se você ainda não tem uma conta na monday.com:

1. Acesse monday.com e cadastre-se para criar uma conta
2. Crie seu primeiro workspace e quadro para começar

Passo 2: Gere um Token de API

Para interagir com a API da monday.com, você precisará de um token de API:

1. Faça login na sua conta da monday.com
2. Clique no seu avatar no canto inferior esquerdo
3. Selecione "Developers"
4. Clique em "My access tokens" no menu à esquerda
5. Copie seu token de acesso pessoal

Passo 3: Configure Seu Cliente MCP

Para Claude Desktop

1. Abra o Claude Desktop
2. Vá para Configurações → Servidores MCP
3. Adicione um novo servidor com esta configuração:

{
  "mcpServers": {
    "monday-api-mcp": {
      "command": "npx",
      "args": [
        "@mondaydotcomorg/monday-api-mcp@latest"
      ],
      "env": {
        "MONDAY_TOKEN": "your_monday_api_token"
      }
    }
  }
}

Para Gemini CLI

Para começar com o Gemini CLI, você pode usar a extensão oficial do Gemini CLI para a monday.com.

A extensão do Gemini CLI agrupa o servidor MCP da monday.com com um arquivo de contexto e comandos personalizados que ensinam o Gemini a usar as ferramentas da monday.com para fluxos de trabalho poderosos.

Para instalar a extensão, execute o seguinte comando no seu terminal:

gemini extensions install https://github.com/mondaycom/mcp

Se você preferir usar o servidor MCP diretamente sem a extensão, pode adicioná-lo com este comando:

gemini mcp add -t http monday https://mcp.monday.com/mcp

Depois de instalar a extensão ou adicionar o servidor MCP, inicie o Gemini CLI executando:

gemini

Em seguida, autentique-se com sua conta da monday.com executando o seguinte comando dentro do Gemini CLI:

/mcp auth monday

Isso abrirá uma janela do navegador para concluir o processo de autenticação. Após a autenticação, todas as ferramentas da monday.com e comandos personalizados estarão disponíveis.

Alguns comandos personalizados para experimentar com a extensão:

• /monday:create-item criar item no quadro 123 para "Atualizar a interface"
• /monday:sprint-summary resumo da sprint para a sprint 853

Para Cursor ou Outros Clientes MCP (Configuração Local)

Adicione às suas configurações:

{
  "mcpServers": {
    "monday-api-mcp": {
      "command": "npx",
      "args": [
        "@mondaydotcomorg/monday-api-mcp@latest"
      ],
      "env": {
        "MONDAY_TOKEN": "your_monday_api_token"
      }
    }
  }
}

Passo 5: Teste Sua Integração

1. Faça uma pergunta ao Claude ou ao seu assistente de IA, como:

   • "Quais itens tenho no quadro 123?"
   • "Você pode criar um quadro para gerenciar meu projeto?"

2. Seu assistente agora deve ser capaz de interagir com sua conta da monday.com!

⚙️ Configuração Avançada do MCP Hospedado

Usando Cabeçalhos de Autorização

Para especificar um cabeçalho de autorização personalizado e a versão da API com o MCP hospedado:

{
  "mcpServers": {
    "monday-api-mcp-hosted": {
      "command": "npx",
      "args": [
        "-p",
        "node@20",
        "mcp-remote",
        "https://mcp.monday.com/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer <your_token>"
      }
    }
  }
}

Especificando a Versão da API

Você pode especificar a versão da API que deseja usar com o parâmetro --header:

{
  "mcpServers": {
    "monday-api-mcp-hosted": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.monday.com/mcp",
        "--header",
        "Api-Version:${API_VERSION}"
      ],
      "env": {
        "API_VERSION": "2025-07"
      }
    }
  }
}

Instalando o Aplicativo Monday MCP

Para autenticação OAuth e controles de workspace, instale o aplicativo Monday MCP no marketplace:

1. Visite aplicativo monday MCP no marketplace
2. Clique em "Install" e siga as instruções para adicioná-lo à sua conta

🧰 Ferramentas Disponíveis

Nosso servidor MCP fornece um rico conjunto de ferramentas que dão aos assistentes de IA a capacidade de interagir com a monday.com:

Categoria	Ferramenta	Descrição
Operações de Item	create_item	Criar um novo item em um quadro da monday.com com valores de coluna especificados
	delete_item	Excluir um item de um quadro permanentemente
	get_board_items_by_name	Buscar itens por ID do quadro e termo/nome
	create_update	Adicionar uma atualização/comentário a um item específico
	change_item_column_values	Modificar os valores de coluna de um item existente
	move_item_to_group	Mover um item para um grupo diferente dentro do mesmo quadro
Operações de Quadro	create_board	Criar um novo quadro na monday.com com colunas especificadas
	get_board_schema	Recuperar a estrutura de colunas e grupos de um quadro
	create_group	Criar um novo grupo em um quadro da monday.com
	create_column	Adicionar uma nova coluna a um quadro existente
	delete_column	Remover uma coluna de um quadro
Operações de Conta	list_users_and_teams	Recuperar detalhes de usuários ou equipes por ID, nome ou pesquisando na conta
Operações de Formulários	create_form	Criar um novo formulário na monday.com
	get_form	Obter um formulário pelo seu token

🎨 Ferramentas do Framework de Aplicativos da monday.com

Procurando construir aplicativos personalizados da monday.com com assistência de IA? As Ferramentas do Framework de Aplicativos fornecem aos agentes de IA acesso completo à plataforma de desenvolvimento de aplicativos da monday.com, permitindo que você crie, gerencie e implante aplicativos personalizados diretamente por meio de assistentes de IA.

📖 Ver Documentação Completa das Ferramentas do Framework de Aplicativos

🔮 Ferramentas Dinâmicas de API (Beta)

Nosso recurso de Ferramentas Dinâmicas de API representa um avanço significativo em como agentes de IA podem interagir com a monday.com. Embora nossas ferramentas padrão cubram operações comuns, as Ferramentas Dinâmicas de API desbloqueiam o potencial total da API GraphQL da monday.com.

O que são Ferramentas Dinâmicas de API?

As Ferramentas Dinâmicas de API fornecem aos agentes de IA acesso completo e adaptável a toda a superfície da API da monday.com. Isso significa que seu assistente de IA pode:

1. Acessar qualquer endpoint da API - Não apenas as operações predefinidas que construímos
2. Gerar consultas GraphQL personalizadas - Criar exatamente a consulta necessária para qualquer situação
3. Explorar dinamicamente o esquema da monday.com - Entender todos os tipos de dados disponíveis e seus relacionamentos

Principais Ferramentas Dinâmicas de API

Ferramenta	Descrição
all_monday_api	Gerar e executar dinamicamente qualquer consulta ou mutação GraphQL
get_graphql_schema	Buscar o esquema GraphQL da monday.com para entender as operações disponíveis
get_type_details	Recuperar informações detalhadas sobre tipos GraphQL específicos

Possibilidades Desbloqueadas

Com as Ferramentas Dinâmicas de API, seus assistentes de IA podem:

• Criar relatórios complexos abrangendo múltiplos quadros, itens e pontos de dados
• Executar operações em lote em muitos itens simultaneamente
• Integrar profundamente com recursos avançados da monday.com, como documentos, workspaces e logs de atividade
• Descobrir novos recursos à medida que a monday.com adiciona funcionalidades à sua API

Como Ativar

As Ferramentas Dinâmicas de API estão em beta e desativadas por padrão. Ative-as com:

MONDAY_TOKEN=your_monday_api_token npx @mondaydotcomorg/monday-api-mcp@latest --enable-dynamic-api-tools true

Você também pode usar o modo 'only' para ativar exclusivamente as Ferramentas Dinâmicas de API:

MONDAY_TOKEN=your_monday_api_token npx @mondaydotcomorg/monday-api-mcp@latest --enable-dynamic-api-tools only

Quando o modo 'only' está ativado, o servidor fornecerá apenas as Ferramentas Dinâmicas de API, filtrando todas as outras ferramentas padrão. Isso é útil para usuários avançados que desejam trabalhar diretamente com a API GraphQL.

⚠️ Nota: As Ferramentas Dinâmicas de API exigem acesso total à API e não são compatíveis com o modo somente leitura.

🖥️ Configuração do Servidor MCP

Argumento	Flags	Descrição	Obrigatório	Padrão
Token da API monday.com	--token, -t	Token da API da monday.com	Sim	-
Versão da API	--version, -v	Versão da API da monday.com	Não	current
Modo	--mode, -m	Modo de ferramenta: default para ferramentas padrão da plataforma, apps para ferramentas do Framework de Aplicativos	Não	default
Modo Somente Leitura	--read-only, -ro	Ativar modo somente leitura	Não	false
Ferramentas Dinâmicas de API	--enable-dynamic-api-tools, -edat	Ativar ferramentas dinâmicas de API	Não	false

🔐 Autenticação e Segurança

O servidor requer um token da API da monday.com para autenticar com a API da monday.com. Você pode fornecer este token de duas maneiras:

1. Variável de ambiente: MONDAY_TOKEN=your_monday_api_token
2. Argumento de linha de comando: -t your_monday_api_token

Boas Práticas de Segurança

• Nunca compartilhe seu token de API em repositórios públicos ou discussões
• Considere usar o modo somente leitura (--read-only) quando precisar apenas recuperar dados
• Rotacione regularmente seus tokens de API para maior segurança

📚 Exemplos de Casos de Uso

Aqui estão alguns exemplos do que você pode construir com nossas ferramentas:

1. Assistente de IA para Gerenciamento de Projetos

• Criar e gerenciar tarefas em quadros da monday.com
• Obter atualizações sobre o status do projeto
• Mover itens entre grupos conforme eles progridem

2. Análise de Dados e Relatórios

• Extrair dados de quadros da monday.com
• Gerar relatórios e insights
• Criar novos quadros para relatórios

🌐 Comunidade e Suporte

• GitHub Issues: Para relatórios de bugs e solicitações de recursos
• Discussions: Para perguntas e discussões da comunidade
• Documentação para Desenvolvedores do monday.com: Saiba mais sobre a API do monday.com

📚 Documentação

• Documentação do monday API MCP
• Documentação do Agent Toolkit
• Referência da API do monday.com

📋 Pré-requisitos

Antes de usar essas ferramentas, certifique-se de ter:

1. Node.js v20 ou superior instalado
2. NPM v5.2.0 ou superior instalado
3. Um token da API do monday.com

🛠️ Como desenvolver no repositório

Para desenvolver no repositório:

1. Clone o repositório
2. Instale as dependências: yarn install
3. Compile o projeto: yarn build
4. Copie o caminho do arquivo dist/index.js no pacote monday-api-mcp.
5. Altere a configuração para trabalhar localmente

    "monday-api-mcp": {
      "command": "node",
      "args": [
        "<your_full_path_to_the_package>/dist/index.js",
        "--enable-dynamic-api-tools",
        "true"
      ],
      "env": {
        "MONDAY_TOKEN": "your_monday_api_token"
      }
    }

🤝 Contribuindo

Aceitamos contribuições da comunidade! Seja corrigindo bugs, melhorando a documentação ou adicionando novos recursos, sua ajuda é bem-vinda.

1. Faça um fork do repositório
2. Crie sua branch de recurso: git checkout -b feature/amazing-feature
3. Faça commit das suas alterações: git commit -m 'Add some amazing feature'
4. Envie para a branch: git push origin feature/amazing-feature
5. Abra um Pull Request

📄 Licença

Este projeto está licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.

Esclarece-se que o servidor utiliza a API do monday.com, que está sujeita aos Termos de Desenvolvedor do monday.com

---