← Integrations

Notion integration

Amendary reads the Notion pages you watch. It writes approved fixes to those pages and adds dated entries to a product-updates page. Here is what to check before you connect.

Get it on the Notion Marketplace
Connect
Sign in with Notion and pick the pages it may see.
A fix lands as
A direct edit to the page, or a comment.
Languages
One page at a time. Fixes are not carried into translated pages.
Generate docs
New pages under a parent page you pick.

What it reads

Notion asks which pages Amendary may see. Amendary lists their titles through Notion search. Search can miss a page, so you can also add one by pasting its link.

A listed page does nothing until you watch it. Engineering docs are mapped to the repo they describe. Help center pages follow what is set on the connection’s card, under Help articles follow: a GitHub repo, or each new entry on your public changelog.

Amendary reads a whole watched page once to list what it claims, then only the matching sections when a change is checked. Comments are never read.

What it changes

Text blocks on the pages you watch. Bold, links, inline code and mentions on unchanged text stay as they were.

When a fix cannot be placed on a block, Amendary leaves a page comment instead of guessing. A product-updates page is never corrected. It only gains new dated entries.

Notion has no suggested-edit mode for integrations, so an applied fix is a direct edit. It is logged in Amendary and can be undone.

Permissions

The integration asks for these four capabilities, and nothing else:

  • Read content, to list page titles and read the pages you watch.
  • Update content, to fix text on the pages you watch.
  • Insert content, to add product-update entries and create pages when you generate docs.
  • Insert comments, to leave a comment when a fix cannot be placed on a block.

It does not ask to read comments. The access token is stored encrypted.

How a fix lands

  1. Once a day, Amendary checks what shipped against the pages you watch. Engineering docs are checked per landed commit.
  2. It drafts the smallest fix for the passage, with the change as evidence.
  3. New teams start on Review first: every fix waits for you. On Apply automatically (paid plan or your own key), a fix still waits when it states a value the change does not back up, removes content, or adds new text.
  4. Notion pages are checked one by one. A fix is not carried into translated pages, and missing languages are not drafted.

Undo and disconnect

Undo is in the Queue for 30 days. It writes the stored original back, but only if nobody edited the block since. The original lives in Amendary, so undo works on every Notion plan.

A workspace owner can disconnect on the Pages tab. Amendary deletes the connection with its pages, fixes, check results and product-update entries. Reconnecting does not bring them back. Nothing in Notion changes. To remove access in Notion too, remove the integration in Notion’s settings.

Generate and cleanup

Generate docs creates pages under a parent you pick, and can start a product-updates changelog. If docs are already there, it follows their layout.

Cleanup checks the pages you pick, watched or not, against your code and says which to keep, fix or retire, with the proof. It never edits a page.

Diagrams suggests a diagram for a page. It is added as an image only after you approve it.

All three spend credits, shown before the run.

Next steps

Try Amendary with Notion

Connect Notion, choose the pages or articles to watch, and review proposed corrections with the change behind each one.

Free for 14 days with no card, and every edit waits for your review. Or free forever with your own Anthropic API key. Code is never touched.