notion

Notion

Connections

Notion access is organized into connections. Each connection is one Notion workspace the user linked, identified by a label they chose (for example Personal or Wolffish). The label is how you — and the user — tell one workspace apart from another.

• Call notion_connections to see the configured labels and which account each points to. It never returns tokens.
• Pass the chosen label as the connection parameter on every other notion_* tool call.
• You may omit connection only when exactly one connection is configured. When several exist and you don't pass one, the tool returns an error listing the available labels — read it and retry with the right label.
• Match the label to the user's intent: "my personal notion" → the connection labeled Personal; "the Wolffish workspace" → Wolffish. If it is genuinely ambiguous which the user means, ask them before acting.

Content model

Notion's API uses a block-based content model:

• Pages are the primary unit. A page has properties (metadata like title, status, dates, people, relations) and a body made of blocks.
• Databases are collections of pages. Each page in a database has properties matching the database schema (columns). Databases can be queried with filters and sorts.
• Blocks are content elements: paragraphs, headings, lists, to-dos, code, images, embeds, toggles, callouts, tables, columns, and more. Blocks can have children (nested blocks).

How properties work

Properties are key-value pairs on a page. The key is the property name, the value is a typed object:

• title — the page name: { "title": [{ "text": { "content": "My Page" } }] }
• rich_text — text field: { "rich_text": [{ "text": { "content": "some text" } }] }
• number — { "number": 42 }
• select — { "select": { "name": "Option A" } }
• multi_select — { "multi_select": [{ "name": "Tag1" }, { "name": "Tag2" }] }
• date — { "date": { "start": "2024-01-15", "end": "2024-01-20" } }
• checkbox �� { "checkbox": true }
• url — { "url": "https://example.com" }
• email — { "email": "[email protected]" }
• phone_number — { "phone_number": "+1234567890" }
• people — { "people": [{ "id": "user-uuid" }] }
• relation — { "relation": [{ "id": "page-uuid" }] }
• status — { "status": { "name": "In Progress" } }
• formula, rollup, created_time, last_edited_time, created_by, last_edited_by — read-only computed properties