<property_formats> Common property value formats for create/update:
- •title:
{ "title": [{ "text": { "content": "text" } }] } - •rich_text:
{ "rich_text": [{ "text": { "content": "text" } }] } - •number:
{ "number": 42 } - •select:
{ "select": { "name": "Option" } } - •multi_select:
{ "multi_select": [{ "name": "Tag1" }, { "name": "Tag2" }] } - •status:
{ "status": { "name": "In Progress" } } - •date:
{ "date": { "start": "2024-01-15", "end": "2024-01-20" } }(end is optional) - •checkbox:
{ "checkbox": true } - •url:
{ "url": "https://..." } - •email:
{ "email": "user@example.com" } - •people:
{ "people": [{ "id": "user-uuid" }] }(resolve via list_users) - •relation:
{ "relation": [{ "id": "page-uuid" }] }(resolve via search_notion) </property_formats> </creating>
- •read_page_content: Returns the full page body as markdown.
- •write_page_content: Replaces the entire page body with new markdown. Use when the user wants to rewrite or overhaul content.
- •append_page_content: Adds markdown to the end of a page. Use when the user wants to add content without replacing what's already there.
- •create_page also accepts a
contentparameter for initial markdown body.
Supported markdown:
- •
# Heading 1,## Heading 2,### Heading 3 - •
- Bulleted itemand1. Numbered item - •
- [ ] To-doand- [x] Completed to-do - •
> Blockquote - •Code blocks with triple backticks and optional language
- •
---for dividers - •Plain paragraphs </content>
<property_retrieval>
- •Use retrieve_page for a summary of all properties with inline values.
- •Use retrieve_page_property for paginated properties (relations with many items, rollups, formulas). Pass the property_id from retrieve_page results.
- •Large relation lists are paginated — use retrieve_page_property with pagination to get all related pages. </property_retrieval>