Automação do Notion via Rube MCP

Automatize operações do Notion através do toolkit do Notion da Composio via Rube MCP.

Pré-requisitos

• O Rube MCP deve estar conectado (RUBE_SEARCH_TOOLS disponível)
• Conexão ativa com o Notion via RUBE_MANAGE_CONNECTIONS com o toolkit notion
• Sempre chame RUBE_SEARCH_TOOLS primeiro para obter os esquemas de ferramentas atuais

Configuração

Obtenha o Rube MCP: Adicione https://rube.app/mcp como um servidor MCP na configuração do seu cliente. Nenhuma chave de API é necessária — basta adicionar o endpoint e funciona.

1. Verifique se o Rube MCP está disponível confirmando que RUBE_SEARCH_TOOLS responde
2. Chame RUBE_MANAGE_CONNECTIONS com o toolkit notion
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para completar o OAuth do Notion
4. Confirme se o status da conexão mostra ATIVA antes de executar quaisquer fluxos de trabalho

Fluxos de Trabalho Principais

1. Criar e Gerenciar Páginas

Quando usar: O usuário deseja criar, atualizar ou arquivar páginas do Notion

Sequência de ferramentas:

1. NOTION_SEARCH_NOTION_PAGE - Encontrar página pai ou página existente [Pré-requisito]
2. NOTION_CREATE_NOTION_PAGE - Criar uma nova página sob um pai [Opcional]
3. NOTION_RETRIEVE_PAGE - Obter metadados/propriedades da página [Opcional]
4. NOTION_UPDATE_PAGE - Atualizar propriedades, título, ícone, capa da página [Opcional]
5. NOTION_ARCHIVE_NOTION_PAGE - Excluir suavemente (arquivar) uma página [Opcional]

Parâmetros chave:

• query: Texto de busca para SEARCH_NOTION_PAGE
• parent_id: Página pai ou ID do banco de dados
• page_id: ID da página para recuperação/atualização/arquivamento
• properties: Valores de propriedades da página correspondentes ao esquema pai

Armadilhas:

• RETRIEVE_PAGE retorna apenas metadados/propriedades, NÃO o conteúdo do corpo; use FETCH_BLOCK_CONTENTS para o corpo da página
• ARCHIVE_NOTION_PAGE é uma exclusão suave (define archived=true), não uma exclusão permanente
• Buscas amplas podem parecer incompletas, a menos que has_more/next_cursor seja totalmente paginado

2. Consultar e Gerenciar Bancos de Dados

Quando usar: O usuário deseja consultar linhas de banco de dados, inserir entradas ou atualizar registros

Sequência de ferramentas:

1. NOTION_SEARCH_NOTION_PAGE - Encontrar o banco de dados pelo nome [Pré-requisito]
2. NOTION_FETCH_DATABASE - Inspecionar esquema e propriedades [Pré-requisito]
3. NOTION_QUERY_DATABASE / NOTION_QUERY_DATABASE_WITH_FILTER - Consultar linhas [Obrigatório]
4. NOTION_INSERT_ROW_DATABASE - Adicionar novas entradas [Opcional]
5. NOTION_UPDATE_ROW_DATABASE - Atualizar entradas existentes [Opcional]

Parâmetros chave:

• database_id: ID do banco de dados (da busca ou URL)
• filter: Objeto de filtro correspondente à sintaxe de filtro do Notion
• sorts: Array de objetos de ordenação
• start_cursor: Cursor de paginação da resposta anterior
• properties: Valores de propriedades correspondentes ao esquema do banco de dados para inserções/atualizações

Armadilhas:

• 404 object_not_found geralmente significa que o database_id está incorreto ou que o banco de dados não é compartilhado com a integração
• Os resultados são paginados; ignorar has_more/next_cursor trunca silenciosamente as leituras
• Incompatibilidades de esquema ou propriedades obrigatórias ausentes causam 400 validation_error
• Campos de fórmula e somente leitura não podem ser definidos via INSERT_ROW_DATABASE
• Os nomes das propriedades nos filtros devem corresponder exatamente ao esquema (sensível a maiúsculas e minúsculas)

3. Gerenciar Blocos e Conteúdo de Página

Quando usar: O usuário deseja ler, anexar ou modificar blocos de conteúdo em uma página

Sequência de ferramentas:

1. NOTION_FETCH_BLOCK_CONTENTS - Ler blocos filhos de uma página [Obrigatório]
2. NOTION_ADD_MULTIPLE_PAGE_CONTENT - Anexar blocos a uma página [Opcional]
3. NOTION_APPEND_TEXT_BLOCKS - Anexar blocos apenas de texto [Opcional]
4. NOTION_REPLACE_PAGE_CONTENT - Substituir todo o conteúdo da página [Opcional]
5. NOTION_DELETE_BLOCK - Remover um bloco específico [Opcional]

Parâmetros chave:

• block_id / page_id: Página de destino ou ID do bloco
• content_blocks: Array de objetos de bloco (NÃO child_blocks)
• text: Conteúdo de texto simples para APPEND_TEXT_BLOCKS

Armadilhas:

• Use o parâmetro content_blocks, NÃO child_blocks — este último falha na validação
• ADD_MULTIPLE_PAGE_CONTENT falha em páginas arquivadas; desarchive via UPDATE_PAGE primeiro
• Blocos criados estão em response.data.results; persista os IDs dos blocos para edições posteriores
• DELETE_BLOCK é um arquivamento (archived=true), não uma exclusão permanente

4. Gerenciar Esquema do Banco de Dados

Quando usar: O usuário deseja criar bancos de dados ou modificar sua estrutura

Sequência de ferramentas:

1. NOTION_FETCH_DATABASE - Inspecionar o esquema atual [Pré-requisito]
2. NOTION_CREATE_DATABASE - Criar um novo banco de dados [Opcional]
3. NOTION_UPDATE_SCHEMA_DATABASE - Modificar propriedades do banco de dados [Opcional]

Parâmetros chave:

• parent_id: ID da página pai para novos bancos de dados
• title: Título do banco de dados

…