oto.cx
notion

notion

notion.

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

ajouter à otoauth : —prefix : notion_*

setup & usage

⚠ your notion integration token

notion is accessed through an internal integration. create it at notion.so/my-integrations and get the internal integration token.

  • share the pages/databases you want with your integration in notion (... menu → connections) — otherwise it sees nothing
  • for comments, tick "read comments" and "insert comments" in the integration's capabilities (unticked by default)
  • paste the token into oto on your account (/account), notion connector
    • ▸ what you can do

    read and write notion pages, databases and blocks shared with your integration.

  • "find the roadmap page" → notion_search — a zero can mean "nothing is shared with the integration": the response then carries a warning saying how to tell (retry with query=""). a response returns at most 100 objects: has_more: true → pass its next_cursor back as cursor for the next page
  • "what changed yesterday in notion?" → notion_search with query="" and edited_on="YYYY-MM-DD" (UTC day): all objects edited that day, in one response
  • "list the rows of this database where status = to do" → notion_query_database (with filter)
  • "create a page under this project" → notion_create_page
  • "add this paragraph to the page" → notion_append_blocks (position="start" to write at the top)
  • "fix this sentence / rewrite the section" → notion_get_markdown then notion_edit_markdown (search-and-replace)
  • "file this page under Archives" → notion_move_page
  • "comment / reply to the comment" → notion_get_comments, notion_add_comment
  • "add a Due date column to the database" → notion_update_database; "create a database" → notion_create_database
  • "create a table view filtered on To do" → notion_view

    • a database has one or more data sources (notion API 2025-09-03): search returns them under the data_source object. the database tools accept the id of the database OR of its data source — never that of a linked view (a copy of a database placed in another page): use the id of the original database.

    ⚙ multiple comptes

    this connector accepts multiple comptes: each stored credential becomes a named account (one name per compte), at your level, your team's or your org's.

  • the first one doesn't need a name; from the second on, each one carries its own (the first then takes the name "principal", renamable)
  • without specification, the agent takes the only stored compte, otherwise the one marked as default; otherwise the call is refused, naming the available comptes — never a random choice
  • target a compte for a call: _account="<name>" on the tool; list them: oto_identity(op='list', connector='notion') (scope='org' or scope='group' for the org's or team's)
  • set the default: oto_identity(op='set', connector='notion', identity_id='<name>'); rename: op='rename' with new_name
  • ⚠️ no tool walks through the comptes on its own: a total across several comptes is obtained by calling each one (_account) and adding up

    • 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 …
    ← tous les connecteurscatalogue mcp →