Skip to main content Skills Marketplace Découvrez et explorez les compétences IA créées par la communauté.
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Afficher les détails du prompt Une commande directe contourne le prompt de vérification. Examinez la source avant de l'exécuter.
npx skills add https://github.com/ArgentAIOS/argentos-core --skill argentos-notionLa commande reste sur une seule ligne. Faites défiler horizontalement pour la vérifier avant de la copier.
Vous préférez une copie locale ? Téléchargez les fichiers actuellement disponibles dans SkillsMP.
Télécharger Zip Téléchargement... Métiers associés SOC
Basé sur la classification professionnelle SOC
Explorateur de fichiers
2 fichiers name argentos-notion description Notion API for creating and managing pages, databases, and blocks via curl. Search, create, update, and query Notion workspaces directly from the terminal. version 1.0.0 author community license MIT metadata {"argent":{"tags":["Notion","Productivity","Notes","Database","API"],"homepage":"https://developers.notion.com"},"imported_from":{"original_name":"notion","source":"upstream skill profile"}} prerequisites {"env_vars":["NOTION_API_KEY"]}
Notion API
Use the Notion API via curl to create, read, update pages, databases (data sources), and blocks. No extra tools needed — just curl and a Notion API key.
Prerequisites
Create an integration at https://notion.so/my-integrations
Copy the API key (starts with ntn_ or secret_) Store it in ~/.hermes/.env:
NOTION_API_KEY=ntn_your_key_here
Important: Share target pages/databases with your integration in Notion (click "..." → "Connect to" → your integration name)
API Basics All requests use this pattern:
curl -s -X GET "https://api.notion.com/v1/..." \
-H "Authorization: Bearer $NOTION_API_KEY " \
-H "Notion-Version: 2025-09-03" \
-H "Content-Type: application/json"
The Notion-Version header is required. This skill uses 2025-09-03 (latest). In this version, databases are called "data sources" in the API.
Common Operations
Search curl -s -X POST "https://api.notion.com/v1/search" \
-H "Authorization: Bearer $NOTION_API_KEY " \
-H "Notion-Version: 2025-09-03" \
-H "Content-Type: application/json" \
-d '{"query": "page title"}'
Get Page curl -s "https://api.notion.com/v1/pages/{page_id}" \
-H "Authorization: Bearer $NOTION_API_KEY " \
-H "Notion-Version: 2025-09-03"
Get Page Content (blocks) curl -s "https://api.notion.com/v1/blocks/{page_id}/children" \
-H "Authorization: Bearer $NOTION_API_KEY " \
-H "Notion-Version: 2025-09-03"
Create Page in a Database curl -s -X POST "https://api.notion.com/v1/pages" \
-H "Authorization: Bearer $NOTION_API_KEY " \
-H "Notion-Version: 2025-09-03" \
-H "Content-Type: application/json" \
-d '{
"parent": {"database_id": "xxx"},
"properties": {
"Name": {"title": [{"text": {"content": "New Item"}}]},
"Status": {"select": {"name": "Todo"}}
}
}'
Query a Database curl -s -X POST "https://api.notion.com/v1/data_sources/{data_source_id}/query" \
-H "Authorization: Bearer $NOTION_API_KEY " \
-H "Notion-Version: 2025-09-03" \
-H "Content-Type: application/json" \
-d '{
"filter": {"property": "Status", "select": {"equals": "Active"}},
"sorts": [{"property": "Date", "direction": "descending"}]
}'
Create a Database curl -s -X POST "https://api.notion.com/v1/data_sources" \
-H "Authorization: Bearer $NOTION_API_KEY " \
-H "Notion-Version: 2025-09-03" \
-H "Content-Type: application/json" \
-d '{
"parent": {"page_id": "xxx"},
"title": [{"text": {"content": "My Database"}}],
"properties": {
"Name": {"title": {}},
"Status": {"select": {"options": [{"name": "Todo"}, {"name": "Done"}]}},
"Date": {"date": {}}
}
}'
Update Page Properties curl -s -X PATCH "https://api.notion.com/v1/pages/{page_id}" \
-H "Authorization: Bearer $NOTION_API_KEY " \
-H "Notion-Version: 2025-09-03" \
-H "Content-Type: application/json" \
-d '{"properties": {"Status": {"select": {"name": "Done"}}}}'
Add Content to a Page curl -s -X PATCH "https://api.notion.com/v1/blocks/{page_id}/children" \
-H "Authorization: Bearer $NOTION_API_KEY " \
-H "Notion-Version: 2025-09-03" \
-H "Content-Type: application/json" \
-d '{
"children": [
{"object": "block", "type": "paragraph", "paragraph": {"rich_text": [{"text": {"content": "Hello from Hermes!"}}]}}
]
}'
Property Types Common property formats for database items:
Title: {"title": [{"text": {"content": "..."}}]}Rich text: {"rich_text": [{"text": {"content": "..."}}]}Select: {"select": {"name": "Option"}}Multi-select: {"multi_select": [{"name": "A"}, {"name": "B"}]}Date: {"date": {"start": "2026-01-15", "end": "2026-01-16"}}Checkbox: {"checkbox": true}Number: {"number": 42}URL: {"url": "https://..."}Email: {"email": "user@example.com"}Relation: {"relation": [{"id": "page_id"}]}
Key Differences in API Version 2025-09-03
Databases → Data Sources: Use /data_sources/ endpoints for queries and retrievalTwo IDs: Each database has both a database_id and a data_source_id
Use database_id when creating pages (parent: {"database_id": "..."})
Use data_source_id when querying (POST /v1/data_sources/{id}/query)
Search results: Databases return as "object": "data_source" with their data_source_id
Notes
Page/database IDs are UUIDs (with or without dashes)
Rate limit: ~3 requests/second average
The API cannot set database view filters — that's UI-only
Use is_inline: true when creating data sources to embed them in pages
Add -s flag to curl to suppress progress bars (cleaner output for Hermes)
Pipe output through jq for readable JSON: ... | jq '.results[0].properties'
