notion

notion

notion.

Search the workspace (pages + databases shared with the integration).

ajouter à otoauth : —prefix : notion_*

setup & usage

⚠ ton token d'intégration notion

notion s'ouvre via une intégration interne. crée-la sur notion.so/my-integrations, récupère l'internal integration token.

  • partage les pages/databases voulues avec ton intégration dans notion (menu ... → connexions) — sinon elle ne voit rien
  • colle le token dans oto sur ton compte (/account), connecteur notion
  • ▸ ce que tu peux faire

    lis et écris pages, databases et blocs notion partagés avec ton intégration.

  • « retrouve la page roadmap » → notion_search — un zéro peut vouloir dire « rien n'est partagé avec l'intégration » : la réponse porte alors un warning qui dit comment trancher (relancer avec query=""). une réponse rend au plus 100 objets : has_more: true → repasse son next_cursor en cursor pour la page suivante
  • « qu'est-ce qui a changé hier dans notion ? » → notion_search avec query="" et edited_on="AAAA-MM-JJ" (jour UTC) : tous les objets édités ce jour-là, en une réponse
  • « liste les lignes de cette base où statut = à faire » → notion_query_database (avec filtre)
  • « crée une page sous ce projet » → notion_create_page
  • « ajoute ce paragraphe à la page » → notion_append_blocks
  • ⚙ plusieurs comptes

    ce connecteur accepte plusieurs comptes : chaque credential posé devient un compte nommé (un nom par compte), à ton niveau, à celui de ton équipe ou de ton org.

  • le premier n'a pas besoin de nom ; à partir du deuxième, chacun porte le sien (le premier prend alors le nom « principal », renommable)
  • sans précision, l'agent prend le seul compte posé, sinon celui marqué par défaut ; sinon l'appel est refusé en nommant les comptes disponibles — jamais un choix au hasard
  • viser un compte pour un appel : _account="<nom>" sur l'outil ; les lister : oto_identity(op='list', connector='notion') (scope='org' ou scope='group' pour ceux de l'org ou de l'équipe)
  • fixer le défaut : oto_identity(op='set', connector='notion', identity_id='<nom>') ; renommer : op='rename' avec new_name
  • ⚠️ aucun outil ne parcourt les comptes tout seul : un total sur plusieurs comptes s'obtient en appelant chacun (_account) et en additionnant
  • outils

    chargement…

    utilisation

    claude code — installe le plugin oto — claude plugin marketplace add otomata-tech/oto-plugin — mcp + skill configurés.
    claude.ai — branche mcp.oto.cx/mcp en connecteur custom (guide)
    cli — pipx install oto-cli puis oto notion …