Monday MCP
Visão geral
Seção intitulada “Visão geral”O monday.com é uma plataforma de gestão de trabalho que organiza projetos, fluxos e processos de clientes em quadros, documentos e dashboards. Com a integração no SquadOS, seus agentes podem criar e atualizar itens, gerenciar quadros, redigir documentos, controlar sprints de desenvolvimento e executar qualquer operação da API do monday.com via GraphQL.
- Site oficial: https://monday.com/
- Documentação na Composio: docs.composio.dev/toolkits/monday_mcp
Autenticação
Seção intitulada “Autenticação”Esta ferramenta utiliza OAuth 2.0 com registro dinâmico de cliente (DCR_OAUTH) para conectar.
Como o aplicativo gerenciado pela Composio não está disponível para esta integração, você precisará criar um aplicativo desenvolvedor no monday.com e fornecer suas credenciais OAuth.
Você vai precisar dos seguintes campos:
| Campo | Obrigatório | Descrição |
|---|---|---|
client_id | Sim | ID do cliente OAuth gerado ao criar o aplicativo no portal de desenvolvedores do monday.com. |
client_secret | Sim | Segredo do cliente OAuth gerado junto ao Client ID no portal de desenvolvedores do monday.com. |
Como obter a credencial
Seção intitulada “Como obter a credencial”- Acesse monday.com/developers/apps, faça login e clique em Create App.
- Dê um nome ao aplicativo (por exemplo,
Composio-Monday) e salve. - Copie o Client ID e o Client Secret gerados automaticamente — guarde-os em local seguro.
- Na seção Redirect URLs, adicione a seguinte URL de callback (sem barra ao final):
https://backend.composio.dev/api/v3/toolkits/auth/callback - Na seção OAuth Scopes, adicione os escopos necessários, por exemplo:
boards:read,boards:write,items:read,items:write,users:read,docs:read,docs:write,updates:read,updates:write,workspaces:read,workspaces:write - Salve o aplicativo. Você usará o Client ID e o Client Secret ao configurar a conexão na Composio.
Como conectar no SquadOS
Seção intitulada “Como conectar no SquadOS”- Acesse Ferramentas no menu lateral (
/admin/tools). - Abra a aba Disponíveis e procure por
Monday MCP. - Clique no card para abrir o modal de detalhes e em Conectar.
- Você é levado para a página de conexão segura hospedada pela Composio, onde informa o Client ID e o Client Secret obtidos acima e autoriza o acesso via OAuth.
- Ao concluir, você volta para o SquadOS com a conta conectada e a ferramenta disponível para os agentes. (Detalhes do fluxo em Ferramentas da Organização.)
Ações disponíveis
Seção intitulada “Ações disponíveis”API geral do monday
Seção intitulada “API geral do monday”MONDAY_MCP_ALL_MONDAY_API
Executa qualquer operação da API do monday.com gerando queries e mutations GraphQL dinamicamente. Use get_graphql_schema e get_type_details para entender o schema antes de elaborar a query.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
query | string | Sim | Query ou mutation GraphQL personalizada. Forneça a query/mutation completa. |
variables | string | Sim | String JSON contendo as variáveis para a operação GraphQL. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Schema de todos os widgets
Seção intitulada “Schema de todos os widgets”MONDAY_MCP_ALL_WIDGETS_SCHEMA
Busca as definições completas em JSON Schema 7 para todos os tipos de widget disponíveis no monday.com. Use antes de criar widgets para entender os campos obrigatórios, tipos de dados e regras de validação de cada tipo.
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Insights do quadro
Seção intitulada “Insights do quadro”MONDAY_MCP_BOARD_INSIGHTS
Calcula insights sobre os dados de um quadro aplicando filtros, agrupamentos e agregações em colunas. Use para obter resumos como total de itens, contagem por status ou por coluna. Use get_board_info antes se não conhecer a estrutura do quadro.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
boardId | number | Sim | ID do quadro para o qual obter insights. |
limit | number | Não | Limite de resultados a retornar. |
filters | array | Não | Configuração de filtros a aplicar nos itens. Consulte get_board_info para verificar as diretrizes de filtragem por coluna. |
groupBy | array | Não | Colunas para agrupar. Todas as colunas do agrupamento devem estar também nas agregações. |
orderBy | array | Não | Colunas para ordenar os resultados. |
aggregations | array | Não | Agregações a calcular. Consulte get_board_info para diretrizes. |
filtersOperator | string ("and" ou "or") | Não | Operador lógico a usar nos filtros. |
filtersStringified | string | Não | Apenas para Microsoft Copilot: filtros como string JSON do array filters. |
orderByStringified | string | Não | Apenas para Microsoft Copilot: ordenação como string JSON do array orderBy. |
aggregationsStringified | string | Não | Apenas para Microsoft Copilot: agregações como string JSON do array aggregations. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Alterar valores de colunas de um item
Seção intitulada “Alterar valores de colunas de um item”MONDAY_MCP_CHANGE_ITEM_COLUMN_VALUES
Altera os valores de colunas de um item em um quadro do monday.com.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
itemId | number | Sim | ID do item a ser atualizado. |
boardId | number | Sim | ID do quadro que contém o item. |
columnValues | string | Sim | String com os novos valores de coluna no formato {"column_id": "valor", ...}. Para coluna de status use {"label": "Done"}; para data use {"date": "2023-05-25"}. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Criar quadro
Seção intitulada “Criar quadro”MONDAY_MCP_CREATE_BOARD
Cria um novo quadro no monday.com.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
boardName | string | Sim | Nome do quadro a criar. |
boardKind | string ("private", "public" ou "share") | Não | Tipo de visibilidade do quadro. |
workspaceId | string | Não | ID do espaço de trabalho onde criar o quadro. |
boardDescription | string | Não | Descrição do quadro. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Criar coluna
Seção intitulada “Criar coluna”MONDAY_MCP_CREATE_COLUMN
Cria uma nova coluna em um quadro do monday.com.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
boardId | number | Sim | ID do quadro ao qual a nova coluna será adicionada. |
columnType | string | Sim | Tipo da coluna (ex.: "text", "status", "date", "numbers", "people", "timeline", entre outros). |
columnTitle | string | Sim | Título da coluna a criar. |
columnSettings | string | Não | Configurações específicas da coluna como string JSON. Use get_column_type_info para obter o schema do tipo. |
columnDescription | string | Não | Descrição da coluna. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Criar dashboard
Seção intitulada “Criar dashboard”MONDAY_MCP_CREATE_DASHBOARD
Cria um novo dashboard no monday.com que agrega dados de um ou mais quadros. Use para criar visualizações de dados e containers para widgets.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
name | string | Sim | Título do dashboard (UTF-8). |
board_ids | array | Sim | Lista de IDs de quadros como strings (mínimo 1 elemento). |
workspace_id | string | Sim | ID do espaço de trabalho dono do dashboard. |
kind | string ("PRIVATE" ou "PUBLIC") | Não | Visibilidade do dashboard. |
board_folder_id | string | Não | ID opcional de pasta dentro do espaço de trabalho. Se não fornecido, o dashboard é criado na raiz. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Criar documento
Seção intitulada “Criar documento”MONDAY_MCP_CREATE_DOC
Cria um novo documento no monday.com dentro de um espaço de trabalho ou vinculado a um item via coluna de documento. Após a criação, o conteúdo em markdown fornecido é adicionado ao documento.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
doc_name | string | Sim | Nome do novo documento. |
location | string ("workspace" ou "item") | Sim | Local onde o documento será criado: em um espaço de trabalho ou vinculado a um item. |
markdown | string | Sim | Conteúdo em markdown a importar para o documento como blocos. |
item_id | number | Não | Obrigatório quando location="item": ID do item ao qual o documento será vinculado. |
doc_kind | string ("private", "public" ou "share") | Não | Tipo do documento; apenas quando location="workspace". Padrão: public. |
column_id | string | Não | Opcional quando location="item": ID de uma coluna do tipo doc existente no quadro. Se não fornecido, uma nova coluna será criada automaticamente. |
folder_id | number | Não | Opcional quando location="workspace": ID de pasta para posicionar o documento. |
workspace_id | number | Não | Obrigatório quando location="workspace": ID do espaço de trabalho onde criar o documento. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Criar pasta
Seção intitulada “Criar pasta”MONDAY_MCP_CREATE_FOLDER
Cria uma nova pasta em um espaço de trabalho do monday.com.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
name | string | Sim | Nome da pasta a criar. |
workspaceId | string | Sim | ID do espaço de trabalho onde a pasta será criada. |
color | string | Não | Cor da pasta (ex.: "BRIGHT_BLUE", "PURPLE", "DONE_GREEN"). |
customIcon | string | Não | Ícone personalizado da pasta ("FOLDER", "WORK", etc.). |
fontWeight | string | Não | Peso da fonte do nome da pasta ("FONT_WEIGHT_BOLD", "FONT_WEIGHT_NORMAL", etc.). |
parentFolderId | string | Não | ID da pasta pai. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Criar formulário
Seção intitulada “Criar formulário”MONDAY_MCP_CREATE_FORM
Cria um formulário no monday.com. Cria também um novo quadro para armazenar as respostas. O board_id retornado é o ID do quadro criado; o formToken é usado em todas as operações futuras sobre o formulário.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
destination_workspace_id | string | Sim | ID do espaço de trabalho onde o formulário será criado. |
board_kind | string ("private", "public" ou "share") | Não | Tipo de visibilidade do quadro criado para as respostas. |
board_owner_ids | array | Não | IDs de usuários com permissão de proprietário no quadro de respostas. |
destination_name | string | Não | Nome do quadro que armazenará as respostas. |
board_owner_team_ids | array | Não | IDs de equipes com permissão de proprietário no quadro. |
board_subscriber_ids | array | Não | IDs de usuários que receberão notificações de atividade. |
destination_folder_id | string | Não | ID da pasta onde o formulário será criado. |
destination_folder_name | string | Não | Nome da pasta onde o formulário será criado. |
board_subscriber_teams_ids | array | Não | IDs de equipes que receberão notificações de atividade. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Criar grupo
Seção intitulada “Criar grupo”MONDAY_MCP_CREATE_GROUP
Cria um novo grupo em um quadro do monday.com. Grupos são seções que organizam itens relacionados. Podem ser posicionados em relação a grupos existentes e receber cores predefinidas.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
boardId | string | Sim | ID do quadro onde criar o grupo. |
groupName | string | Sim | Nome do novo grupo (máximo 255 caracteres). |
groupColor | string | Não | Cor do grupo. Deve ser uma das cores predefinidas do monday.com (ex.: "#00c875", "#579bfc", "#df2f4a"). |
relativeTo | string | Não | ID do grupo em relação ao qual posicionar o novo grupo. |
positionRelativeMethod | string ("after_at" ou "before_at") | Não | Se o novo grupo deve ser posicionado antes ou depois do grupo de referência. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Criar item
Seção intitulada “Criar item”MONDAY_MCP_CREATE_ITEM
Cria um novo item com os valores fornecidos, cria um subitem sob um item pai, ou duplica um item existente e o atualiza com novos valores. Use parentItemId para criar subitens e duplicateFromItemId para copiar com modificações.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
name | string | Sim | Nome do novo item a ser criado. |
boardId | number | Sim | ID do quadro ao qual o novo item será adicionado. |
columnValues | string | Sim | String com os valores de coluna no formato {"column_id": "valor", ...}. Para status use {"label": "Done"}; para data use {"date": "2023-05-25"}. |
groupId | string | Não | ID do grupo ao qual o item será adicionado. Se não especificado, vai para o grupo do topo. |
parentItemId | number | Não | ID do item pai sob o qual o subitem será criado. |
duplicateFromItemId | number | Não | ID do item existente a duplicar (apenas ao duplicar). |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Criar atualização
Seção intitulada “Criar atualização”MONDAY_MCP_CREATE_UPDATE
Cria uma nova atualização (comentário/post) em um item do monday.com. Pode mencionar usuários, equipes ou quadros.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
body | string | Sim | Texto da atualização. Não use @ para mencionar — use o campo mentionsList. |
itemId | number | Sim | ID do item ao qual a atualização será adicionada. |
mentionsList | string | Não | Array JSON de menções no formato: [{"id": "123", "type": "User"}, {"id": "456", "type": "Team"}]. Tipos válidos: User, Team, Board, Project. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Criar widget
Seção intitulada “Criar widget”MONDAY_MCP_CREATE_WIDGET
Cria um novo widget em um dashboard ou visualização de quadro com configurações específicas. Sempre use all_widgets_schema para obter os schemas antes de criar widgets.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
widget_kind | string ("BATTERY", "CALENDAR", "CHART", "GANTT", "NUMBER" ou "TABLE") | Sim | Tipo do widget a criar. |
widget_name | string | Sim | Nome de exibição do widget (1–255 caracteres UTF-8). |
parent_container_id | string | Sim | ID do container pai (dashboard ou visualização de quadro). |
parent_container_type | string ("BOARD_VIEW" ou "DASHBOARD") | Sim | Tipo do container pai. |
settings | object | Não | Configurações específicas do widget como objeto JSON conforme o schema do tipo. |
settingsStringified | string | Não | Apenas para Microsoft Copilot: configurações como string JSON do campo settings. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Criar espaço de trabalho
Seção intitulada “Criar espaço de trabalho”MONDAY_MCP_CREATE_WORKSPACE
Cria um novo espaço de trabalho no monday.com.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
name | string | Sim | Nome do novo espaço de trabalho. |
workspaceKind | string ("closed", "open" ou "template") | Sim | Tipo do espaço de trabalho. |
description | string | Não | Descrição do espaço de trabalho. |
accountProductId | string | Não | ID do produto de conta associado ao espaço de trabalho. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Editor de perguntas de formulário
Seção intitulada “Editor de perguntas de formulário”MONDAY_MCP_FORM_QUESTIONS_EDITOR
Cria, atualiza ou exclui uma pergunta em um formulário do monday.com.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
action | string ("delete", "update" ou "create") | Sim | Operação a realizar. Para atualizar ou excluir, questionId é obrigatório. Para criar ou atualizar, o objeto question é obrigatório. |
formToken | string | Sim | Token identificador único do formulário. |
question | object | Não | Objeto com as propriedades da pergunta para criação ou atualização. O campo title é obrigatório ao criar. |
questionId | string | Não | ID único da pergunta. Necessário ao atualizar ou excluir. |
questionStringified | string | Não | Apenas para Microsoft Copilot: objeto question como string JSON. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter atividade do quadro
Seção intitulada “Obter atividade do quadro”MONDAY_MCP_GET_BOARD_ACTIVITY
Obtém os logs de atividade de um quadro para um intervalo de tempo especificado (padrão: últimos 30 dias).
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
boardId | number | Sim | ID do quadro para o qual obter atividade. |
toDate | string | Não | Data final do intervalo (formato ISO8601DateTime). Padrão: agora. |
fromDate | string | Não | Data inicial do intervalo (formato ISO8601DateTime). Padrão: 30 dias atrás. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter informações do quadro
Seção intitulada “Obter informações do quadro”MONDAY_MCP_GET_BOARD_INFO
Obtém informações abrangentes do quadro, incluindo metadados, estrutura, proprietários e configuração.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
boardId | number | Sim | ID do quadro para o qual obter informações. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter itens do quadro (paginado)
Seção intitulada “Obter itens do quadro (paginado)”MONDAY_MCP_GET_BOARD_ITEMS_PAGE
Obtém todos os itens de um quadro com suporte a paginação e valores de coluna opcionais. Use o nextCursor da resposta para obter a próxima página quando has_more for verdadeiro.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
boardId | number | Sim | ID do quadro do qual obter itens. |
limit | number | Não | Número de itens a retornar por página. |
cursor | string | Não | Cursor para a próxima página, obtido do campo nextCursor da resposta anterior. |
filters | array | Não | Filtros a aplicar nos itens. Consulte get_board_info para diretrizes. |
itemIds | array | Não | IDs de itens específicos a buscar (máximo 100). |
orderBy | array | Não | Colunas para ordenar os resultados. |
columnIds | array | Não | IDs das colunas a incluir na resposta (reduz o tamanho). Funciona apenas com includeColumns=true. |
searchTerm | string | Não | Termo de busca para termos vagos ou aproximados. Prefira filtros estruturados para valores exatos. |
subItemLimit | number | Não | Número de subitens por item. Usado apenas com includeSubItems=true. |
includeColumns | boolean | Não | Se deve incluir valores de coluna na resposta. Omitir melhora performance quando você só precisa de IDs/nomes. |
filtersOperator | string ("and" ou "or") | Não | Operador lógico para os filtros. |
includeSubItems | boolean | Não | Se deve incluir subitens na resposta. |
filtersStringified | string | Não | Apenas para Microsoft Copilot: filtros como string JSON. |
orderByStringified | string | Não | Apenas para Microsoft Copilot: ordenação como string JSON. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter informações de tipo de coluna
Seção intitulada “Obter informações de tipo de coluna”MONDAY_MCP_GET_COLUMN_TYPE_INFO
Recupera informações abrangentes sobre um tipo de coluna específico, incluindo definição JSON Schema e metadados. Use antes de criar colunas com create_column.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
columnType | string | Sim | Tipo de coluna a consultar (ex.: "text", "status", "date", "numbers"). |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter formulário
Seção intitulada “Obter formulário”MONDAY_MCP_GET_FORM
Obtém um formulário do monday.com pelo seu token. O token pode ser extraído da URL do formulário — é a string alfanumérica entre /forms/ e o ?.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
formToken | string | Sim | Token identificador único do formulário. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter schema GraphQL
Seção intitulada “Obter schema GraphQL”MONDAY_MCP_GET_GRAPHQL_SCHEMA
Busca a estrutura do schema GraphQL do monday.com, incluindo definições de queries e mutations disponíveis. Pode filtrar por tipo de operação (leitura/escrita).
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
operationType | string ("read" ou "write") | Não | Tipo de operação: "read" para queries, "write" para mutations. |
random_string | string | Não | Parâmetro fictício para ferramentas sem parâmetros. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter quadros de sprints do monday Dev
Seção intitulada “Obter quadros de sprints do monday Dev”MONDAY_MCP_GET_MONDAY_DEV_SPRINTS_BOARDS
Descobre os quadros de sprints do monday-dev e seus quadros de tarefas associados na conta. Retorna pares de quadros de sprints e tarefas com IDs, nomes e informações de espaço de trabalho.
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter metadados de sprints
Seção intitulada “Obter metadados de sprints”MONDAY_MCP_GET_SPRINTS_METADATA
Obtém metadados abrangentes de sprints de um quadro de sprints do monday-dev: ID, nome, datas planejadas/reais, status de conclusão, status de ativação e ID do documento de resumo.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
sprintsBoardId | number | Sim | ID do quadro monday-dev que contém os sprints. |
limit | number | Não | Número de sprints a recuperar (padrão: 25, máximo: 100). |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter resumo do sprint
Seção intitulada “Obter resumo do sprint”MONDAY_MCP_GET_SPRINT_SUMMARY
Obtém o resumo completo e a análise de um sprint concluído: gestão de escopo, velocidade individual, distribuição de tarefas por tipo e recomendações de IA.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
sprintId | number | Sim | ID do sprint para o qual obter o resumo (ex.: 9123456789). O sprint deve estar concluído e ter sido criado após 01/01/2025. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter detalhes de tipo GraphQL
Seção intitulada “Obter detalhes de tipo GraphQL”MONDAY_MCP_GET_TYPE_DETAILS
Obtém informações detalhadas sobre um tipo GraphQL específico do schema da API do monday.com.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
typeName | string | Sim | Nome do tipo GraphQL para o qual obter detalhes. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter contexto do usuário
Seção intitulada “Obter contexto do usuário”MONDAY_MCP_GET_USER_CONTEXT
Busca informações do usuário atual e seus itens relevantes (quadros, pastas, espaços de trabalho, dashboards). Use no início de conversas para obter contexto sobre quem é o usuário e descobrir seus quadros e itens mais acessados.
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Listar usuários e equipes
Seção intitulada “Listar usuários e equipes”MONDAY_MCP_LIST_USERS_AND_TEAMS
Busca dados de usuários e/ou equipes. Priorize parâmetros específicos na ordem: getMe → userIds → name (apenas usuários) → teamIds + teamsOnly. Evite consultas sem parâmetros.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
name | string | Não | Busca por nome de usuário com correspondência aproximada. Não funciona para equipes. |
getMe | boolean | Não | Use sempre que precisar de informações do usuário atual. Conflita com todos os outros parâmetros. |
teamIds | array | Não | IDs de equipes específicas a buscar. |
userIds | array | Não | IDs de usuários específicos a buscar. |
teamsOnly | boolean | Não | Busca apenas equipes, sem usuários. |
includeTeams | boolean | Não | Busca todas as equipes da conta. Evitar — use userIds para obter as equipes de um usuário específico. |
includeTeamMembers | boolean | Não | Inclui detalhes adicionais dos membros de equipes além de nomes e IDs. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Listar espaços de trabalho
Seção intitulada “Listar espaços de trabalho”MONDAY_MCP_LIST_WORKSPACES
Lista todos os espaços de trabalho disponíveis para o usuário. Retorna até 500 espaços de trabalho com ID, nome e descrição.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
page | number | Não | Número da página a retornar. Padrão: 1. |
limit | number | Não | Número de espaços de trabalho a retornar. Padrão e máximo: 100. |
searchTerm | string | Não | Termo de busca para filtrar espaços de trabalho. Suporta apenas caracteres alfanuméricos. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Mover objeto
Seção intitulada “Mover objeto”MONDAY_MCP_MOVE_OBJECT
Move uma pasta, quadro ou overview no monday.com. Use position para posicionamento relativo, parentFolderId para mudança de pasta, workspaceId para mudança de espaço de trabalho.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | string | Sim | ID do objeto a mover. |
objectType | string ("Board", "Folder" ou "Overview") | Sim | Tipo do objeto a mover. |
workspaceId | string | Não | ID do espaço de trabalho de destino (obrigatório ao mover para outro espaço). |
parentFolderId | string | Não | ID da nova pasta pai (obrigatório ao mover para outra pasta). |
accountProductId | string | Não | ID do produto de conta de destino. |
position_is_after | boolean | Não | Se posicionar o objeto após o objeto de referência. |
position_object_id | string | Não | ID do objeto de referência para posicionamento relativo. |
position_object_type | string ("Board", "Folder" ou "Overview") | Não | Tipo do objeto de referência para posicionamento. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Ler documentos
Seção intitulada “Ler documentos”MONDAY_MCP_READ_DOCS
Obtém uma coleção de documentos do monday.com com seu conteúdo em markdown, com suporte a paginação e filtros por tipo de ID.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ids | array | Sim | Array de valores de ID para a consulta (mínimo 1). |
type | string ("ids", "object_ids" ou "workspace_ids") | Sim | Tipo de consulta: por IDs de documento, IDs de objeto ou IDs de espaço de trabalho. |
page | number | Não | Número da página (começa em 1). Verifique has_more_pages na resposta para paginar. |
limit | number | Não | Número de documentos por página (padrão: 25). |
order_by | string ("created_at" ou "used_at") | Não | Ordem de recuperação dos documentos. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Pesquisar
Seção intitulada “Pesquisar”MONDAY_MCP_SEARCH
Pesquisa dentro da plataforma monday.com por quadros, documentos, formulários ou pastas. Para usuários e equipes use list_users_and_teams; para espaços de trabalho use list_workspaces; para itens use get_board_items_page. Os IDs retornados têm prefixo do tipo (ex.: doc-123) — remova o prefixo ao passar para outras ferramentas.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
searchType | string ("BOARD", "DOCUMENTS" ou "FOLDERS") | Sim | Tipo de pesquisa a realizar. |
page | number | Não | Número da página. Padrão: 1. |
limit | number | Não | Número de itens a retornar. Máximo e padrão: 100. |
searchTerm | string | Não | Termo de busca. |
workspaceIds | array | Não | IDs dos espaços de trabalho onde pesquisar. Informe apenas se o usuário pediu explicitamente. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Atualizar pasta
Seção intitulada “Atualizar pasta”MONDAY_MCP_UPDATE_FOLDER
Atualiza uma pasta existente no monday.com.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
folderId | string | Sim | ID da pasta a atualizar. |
name | string | Não | Novo nome da pasta. |
color | string | Não | Nova cor da pasta. |
customIcon | string | Não | Novo ícone personalizado da pasta. |
fontWeight | string | Não | Novo peso de fonte do nome da pasta. |
workspaceId | string | Não | ID do espaço de trabalho que contém a pasta. |
parentFolderId | string | Não | ID da nova pasta pai. |
accountProductId | string | Não | ID do produto de conta associado. |
position_is_after | boolean | Não | Se posicionar a pasta após o objeto de referência. |
position_object_id | string | Não | ID do objeto de referência para posicionamento. |
position_object_type | string ("Board", "Folder" ou "Overview") | Não | Tipo do objeto de referência para posicionamento. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Atualizar formulário
Seção intitulada “Atualizar formulário”MONDAY_MCP_UPDATE_FORM
Atualiza um formulário do monday.com. Cada chamada executa uma ação por vez: atualizar configurações de recursos, aparência, acessibilidade, título, descrição, ordem de perguntas, tags, senha ou URL.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
action | string | Sim | Ação a executar: activate, deactivate, shortenFormUrl, setFormPassword, createTag, deleteTag, updateTag, updateAppearance, updateAccessibility, updateFeatures, updateQuestionOrder ou updateFormHeader. |
formToken | string | Sim | Token identificador único do formulário. |
tag | object | Não | Dados de tag para criar, atualizar ou excluir. |
form | object | Não | Dados do formulário a atualizar (aparência, acessibilidade, recursos, ordem ou cabeçalho). |
formPassword | string | Não | Senha para proteger o formulário. Obrigatório para setFormPassword. |
tagStringified | string | Não | Apenas para Microsoft Copilot: objeto tag como string JSON. |
formStringified | string | Não | Apenas para Microsoft Copilot: objeto form como string JSON. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Atualizar espaço de trabalho
Seção intitulada “Atualizar espaço de trabalho”MONDAY_MCP_UPDATE_WORKSPACE
Atualiza um espaço de trabalho existente no monday.com.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | string | Sim | ID do espaço de trabalho a atualizar. |
attributeKind | string ("closed", "open" ou "template") | Não | Novo tipo do espaço de trabalho. |
attributeName | string | Não | Novo nome do espaço de trabalho. |
attributeDescription | string | Não | Nova descrição do espaço de trabalho. |
attributeAccountProductId | number | Não | ID do produto de conta de destino ao mover o espaço de trabalho. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Informações do espaço de trabalho
Seção intitulada “Informações do espaço de trabalho”MONDAY_MCP_WORKSPACE_INFO
Retorna os quadros, documentos e pastas em um espaço de trabalho e indica em qual pasta cada um está. Retorna até 100 objetos de cada tipo.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
workspace_id | number | Sim | ID do espaço de trabalho para o qual obter informações. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |