Notion

With the Notion source, the agent reads the Notion pages you mention to understand your project: a spec, a site’s copy, a feature list, a product database. You write “build it from my Notion page”, it finds the page, reads it and builds.

The connection is read-only: the agent never creates, edits or deletes anything in your Notion.

What the agent can read

• The pages your connection gives access to: titles, text, lists, tables.
• Notion databases (task, product or content lists), to use as a spec or as starting data.
• Search: it can look a page up by title or content if you don’t give a link.

It reads while answering, only when your request calls for it, never otherwise.

Connect Notion

1. Open the Connectors page from the sidebar.
2. Find the Notion card in the Context for the agent category (Used by → The agent filter) and open its details.
3. Click Connect. A Notion window opens.
4. Sign in to Notion if needed, choose the workspace and authorize Highwind. The agent will be able to read the pages this authorization gives access to.
5. The window closes and the card shows Connected (“Connected: the agent can read your pages”).

Two Notions in the catalog

The Connectors page and the + menu offer two Notions. The one in the Context for the agent category is this source: the agent reads your pages to build. The one in the Data category is an app connector: your app shows your Notion content to its visitors, with a Notion internal connection token.

Example requests

Mention the page by its title, or paste its link. The @Notion mention (+ menu → Connectors → Notion, Context for the agent category) makes it clear the agent should look at it.

@Notion Build the app described in my "Spec — Booking app" page. Start with the screens listed in the MVP section.

Use the copy from my Notion page "Website — Content" for the home page and the About page, word for word.

My Notion database "Catalog" holds my products (name, price, description). Create a catalog page with these products.

Read the Notion page "Beta feedback" and propose a plan for the most requested fixes.

The last request works great in Discussion mode: the agent reads the page and proposes a plan without changing anything, then you click Apply this plan.

Copied data, not synced

When the agent brings a Notion list or database into your app, it copies the content into the code at the time of your request. If you edit the page afterwards, ask it to read it again. For your app to always show Notion’s latest content, use the Notion app connector instead.

Limits

• Read-only: the agent only gets the Notion server’s read tools. It can’t write to a page, create one or tick a task.
• What your connection sees: a page the authorization doesn’t give access to can’t be found by the agent.
• Very long pages: what the agent receives from a single call is capped (about 20,000 characters). For a very long page, mention the section you want.
• Images in a page: the agent mostly works from the page’s text; for it to reproduce a specific visual, attach a screenshot to your message instead.

Disconnect or reconnect

• Disconnect: Connectors page → Notion details → Disconnect. Highwind revokes its access at Notion when possible and erases its tokens.
• Reconnect: if access has expired or was removed on Notion’s side, the agent tells you. Open the Notion details and connect it again.

See also

Context sourcesHow the agent reads your tools, and privacy.

LinearImplement an issue from its description.

Writing good requestsGive the agent the right level of detail.

Discussion modeHave a spec read and get a plan before building.