Pular pro conteúdo

Notion API skill

O Claude busca, lê e atualiza o seu Notion direto pela API, e pede sua confirmação antes de mudar ou apagar qualquer coisa.

por intellectronica

instalações
94,7 mil
estrelas no GitHub
297
No skills.sh desde
janeiro de 2026
Licença
CC0-1.0

Atualizada no GitHub em 25 de abril de 2026. Dados conferidos em 26 de outubro de 2026, no skills.sh e no GitHub.

O que ela faz

Traz o passo a passo da API do Notion pro Claude usar com curl e jq ou com scripts rápidos: busca, páginas, blocos de conteúdo, bancos de dados com filtro e ordenação, fontes de dados, usuários e comentários, na versão 2025-09-03 da API.

Usa a sua chave do Notion pela variável NOTION_API_TOKEN, pede a chave se não achar e nunca mostra a chave na tela. Antes de editar, arquivar ou criar várias páginas de uma vez, pede sua confirmação; pra um grupo de ações relacionadas, uma confirmação basta.

Também cuida do que costuma dar erro: paginação com has_more, limite de 3 pedidos por segundo com nova tentativa espaçada, no máximo 100 blocos por envio e a tabela de códigos de erro. Arquivos de referência explicam cada tipo de bloco, propriedade, filtro e texto formatado.

Nas palavras de quem fez

This skill provides comprehensive instructions for interacting with the Notion API via REST calls. This skill should be used whenever the user asks to interact…

intellectronica, no SKILL.md

Quando usar

  • Montar uma página de reunião no Notion a partir das suas anotações
  • Puxar as tarefas atrasadas de um banco de dados do Notion
  • Atualizar o status de vários itens de uma vez
  • Levar o conteúdo de um arquivo pro Notion já formatado
  • Responder comentários de uma página

Depois de instalar, é só pedir assim

  • Busca no meu Notion a página de planejamento de outubro e me faz um resumo
  • Cria um banco de dados de clientes no Notion com nome, status e data do próximo contato
  • Lista as tarefas Em andamento no banco de projetos e muda pra Feito as que terminaram ontem

Segurança

Gen Agent Trust Hub, Socket e Snyk leem o código da skill atrás de comando perigoso, dado vazando e instrução escondida. Alerta não é reprovação: quer dizer que vale ler o que a skill faz antes de instalar.

  • Gen Agent Trust HubPassou
  • SocketPassou
  • SnykAlerta

Perguntas

Como instalar a Notion API no Claude Code?

Toca em Levar, aqui nesta página, e deixa seu nome, e-mail e WhatsApp (é uma vez só). Aparece uma frase pronta: cola ela no Claude Code, que ele mesmo instala a Notion API, e a skill passa a valer na próxima conversa. A mesma frase serve no Codex. Se preferir fazer na mão, o passo a passo está em como instalar skills no Claude Code.

O que preciso pra usar?

Uma chave de integração do Notion, guardada na variável NOTION_API_TOKEN ou passada na conversa, e o curl e o jq no computador. As páginas precisam estar compartilhadas com a integração, senão a API responde que não encontrou.

O que ela não faz?

Pela API não dá pra abrir uma discussão nova num trecho da página nem editar ou apagar comentários. E apagar página ou bloco, na prática, manda pro arquivo ou pra lixeira, de onde dá pra recuperar.

Roda no Codex e no Antigravity?

Sim. São chamadas curl comuns; qualquer agente com terminal e a chave do Notion consegue usar.

Levar essa skill

1x notion-apiR$ 0,00

TotalR$ 0,00

A skill sai aqui mesmo, na hora. Seus dados eu uso pra falar com você sobre o MazyOS.

Levar precisa do JavaScript ligado. O código da skill está no GitHub: github.com/intellectronica/agent-skills

Aprenda a usar

Mais da loja intellectronica

Ver a loja intellectronica