notion
starsforks
How to install notion?
adityahimaone/hermes-agent-rtk-caveman/notion
$npx -y skills add adityahimaone/hermes-agent-rtk-caveman --skill notionNotion API for creating and managing pages, databases, and blocks via curl. Search, create, update, and query Notion workspaces directly from the terminal.
SKILL.md
| 1 | # Notion API |
| 2 | |
| 3 | 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. |
| 4 | |
| 5 | ## Prerequisites |
| 6 | |
| 7 | 1. Create an integration at https://notion.so/my-integrations |
| 8 | 2. Copy the API key (starts with `ntn_` or `secret_`) |
| 9 | 3. Store it in `~/.hermes/.env`: |
| 10 | ``` |
| 11 | NOTION_API_KEY=ntn_your_key_here |
| 12 | ``` |
| 13 | 4. **Important:** Share target pages/databases with your integration in Notion (click "..." → "Connect to" → your integration name) |
| 14 | |
| 15 | ## API Basics |
| 16 | |
| 17 | All requests use this pattern: |
| 18 | |
| 19 | ```bash |
| 20 | curl -s -X GET "https://api.notion.com/v1/..." \ |
| 21 | -H "Authorization: Bearer $NOTION_API_KEY" \ |
| 22 | -H "Notion-Version: 2025-09-03" \ |
| 23 | -H "Content-Type: application/json" |
| 24 | ``` |
| 25 | |
| 26 | The `Notion-Version` header is required. This skill uses `2025-09-03` (latest). In this version, databases are called "data sources" in the API. |
| 27 | |
| 28 | ## Common Operations |
| 29 | |
| 30 | ### Search |
| 31 | |
| 32 | ```bash |
| 33 | curl -s -X POST "https://api.notion.com/v1/search" \ |
| 34 | -H "Authorization: Bearer $NOTION_API_KEY" \ |
| 35 | -H "Notion-Version: 2025-09-03" \ |
| 36 | -H "Content-Type: application/json" \ |
| 37 | -d '{"query": "page title"}' |
| 38 | ``` |
| 39 | |
| 40 | ### Get Page |
| 41 | |
| 42 | ```bash |
| 43 | curl -s "https://api.notion.com/v1/pages/{page_id}" \ |
| 44 | -H "Authorization: Bearer $NOTION_API_KEY" \ |
| 45 | -H "Notion-Version: 2025-09-03" |
| 46 | ``` |
| 47 | |
| 48 | ### Get Page Content (blocks) |
| 49 | |
| 50 | ```bash |
| 51 | curl -s "https://api.notion.com/v1/blocks/{page_id}/children" \ |
| 52 | -H "Authorization: Bearer $NOTION_API_KEY" \ |
| 53 | -H "Notion-Version: 2025-09-03" |
| 54 | ``` |
| 55 | |
| 56 | ### Create Page in a Database |
| 57 | |
| 58 | ```bash |
| 59 | curl -s -X POST "https://api.notion.com/v1/pages" \ |
| 60 | -H "Authorization: Bearer $NOTION_API_KEY" \ |
| 61 | -H "Notion-Version: 2025-09-03" \ |
| 62 | -H "Content-Type: application/json" \ |
| 63 | -d '{ |
| 64 | "parent": {"database_id": "xxx"}, |
| 65 | "properties": { |
| 66 | "Name": {"title": [{"text": {"content": "New Item"}}]}, |
| 67 | "Status": {"select": {"name": "Todo"}} |
| 68 | } |
| 69 | }' |
| 70 | ``` |
| 71 | |
| 72 | ### Query a Database |
| 73 | |
| 74 | ```bash |
| 75 | curl -s -X POST "https://api.notion.com/v1/data_sources/{data_source_id}/query" \ |
| 76 | -H "Authorization: Bearer $NOTION_API_KEY" \ |
| 77 | -H "Notion-Version: 2025-09-03" \ |
| 78 | -H "Content-Type: application/json" \ |
| 79 | -d '{ |
| 80 | "filter": {"property": "Status", "select": {"equals": "Active"}}, |
| 81 | "sorts": [{"property": "Date", "direction": "descending"}] |
| 82 | }' |
| 83 | ``` |
| 84 | |
| 85 | ### Create a Database |
| 86 | |
| 87 | ```bash |
| 88 | curl -s -X POST "https://api.notion.com/v1/data_sources" \ |
| 89 | -H "Authorization: Bearer $NOTION_API_KEY" \ |
| 90 | -H "Notion-Version: 2025-09-03" \ |
| 91 | -H "Content-Type: application/json" \ |
| 92 | -d '{ |
| 93 | "parent": {"page_id": "xxx"}, |
| 94 | "title": [{"text": {"content": "My Database"}}], |
| 95 | "properties": { |
| 96 | "Name": {"title": {}}, |
| 97 | "Status": {"select": {"options": [{"name": "Todo"}, {"name": "Done"}]}}, |
| 98 | "Date": {"date": {}} |
| 99 | } |
| 100 | }' |
| 101 | ``` |
| 102 | |
| 103 | ### Update Page Properties |
| 104 | |
| 105 | ```bash |
| 106 | curl -s -X PATCH "https://api.notion.com/v1/pages/{page_id}" \ |
| 107 | -H "Authorization: Bearer $NOTION_API_KEY" \ |
| 108 | -H "Notion-Version: 2025-09-03" \ |
| 109 | -H "Content-Type: application/json" \ |
| 110 | -d '{"properties": {"Status": {"select": {"name": "Done"}}}}' |
| 111 | ``` |
| 112 | |
| 113 | ### Add Content to a Page |
| 114 | |
| 115 | ```bash |
| 116 | curl -s -X PATCH "https://api.notion.com/v1/blocks/{page_id}/children" \ |
| 117 | -H "Authorization: Bearer $NOTION_API_KEY" \ |
| 118 | -H "Notion-Version: 2025-09-03" \ |
| 119 | -H "Content-Type: application/json" \ |
| 120 | -d '{ |
| 121 | "children": [ |
| 122 | {"object": "block", "type": "paragraph", "paragraph": {"rich_text": [{"text": {"content": "Hello from Hermes!"}}]}} |
| 123 | ] |
| 124 | }' |
| 125 | ``` |
| 126 | |
| 127 | ## Property Types |
| 128 | |
| 129 | Common property formats for database items: |
| 130 | |
| 131 | - **Title:** `{"title": [{"text": {"content": "..."}}]}` |
| 132 | - **Rich text:** `{"rich_text": [{"text": {"content": "..."}}]}` |
| 133 | - **Select:** `{"select": {"name": "Option"}}` |
| 134 | - **Multi-select:** `{"multi_select": [{"name": "A"}, {"name": "B"}]}` |
| 135 | - **Date:** `{"date": {"start": "2026-01-15", "end": "2026-01-16"}}` |
| 136 | - **Checkbox:** `{"checkbox": true}` |
| 137 | - **Number:** `{"number": 42}` |
| 138 | - **URL:** `{"url": "https://..."}` |
| 139 | - **Email:** `{"email": "user@example.com"}` |
| 140 | - **Relation:** `{"relation": [{"id": "page_id"}]}` |
| 141 | |
| 142 | ## Key Differences in API Version 2025-09-03 |
| 143 | |
| 144 | - **Databases → Data Sources:** Use `/data_sources/` endpoints for queries and retrieval |
| 145 | - **Two IDs:** Each database has both a `database_id` and a `data_source_id` |
| 146 | - Use `database_id` when creating pages (`parent: {"database_id": "..."}`) |
| 147 | - Use `data_source_id` when querying (`POST /v1/data_sources/{id}/query`) |
| 148 | - **Search results:** Databases return as `"object": "data_source"` with their `data_source_id` |
| 149 | |
| 150 | ## Notes |
| 151 | |
| 152 | - Page/database IDs are UUIDs (with or without dashes) |
| 153 | - Rate limit: ~3 requests/second average |
| 154 | - Th |
People who liked this also viewed
6 picksType
- lark-drive飞书云空间（云盘/云存储）：管理 Drive 文件和文件夹，包含上传/下载、创建文件夹、复制/移动/删除、查看元数据、评论/权限/订阅、标题、版本、飞书文档密级标签（secure labels）和本地文件导入。用户需要整理云盘目录、处理云空间资源 URL/token、判断链接类型/真实 token/标题，或导入 Word/Markdown/Excel/CSV/PPTX/.base 为 docx/sSkillsJul 2026
- lark-sharedUse for lark-cli setup/auth tasks: auth login/status/logout, user vs bot identity, business-domain permissions (--domain, including all/docs/drive), missing scopes, revoking authorization, or handlingSkillsJul 2026
- lark-whiteboard飞书画板：查询和编辑飞书云文档中的画板。支持导出画板为预览图片、导出原始节点结构、使用多种格式更新画板内容。 当用户需要查看画板内容、导出画板图片、编辑画板时使用此 skill。不负责：飞书云文档内容编辑（lark-doc）、文档内嵌电子表格/Base（lark-sheets / lark-base）。SkillsJul 2026
- lark-task飞书任务：管理任务、清单和任务智能体。创建待办任务、查看和更新任务状态、拆分子任务、组织任务清单、分配协作成员、上传任务附件、注册或注销任务智能体、更新任务智能体的主页数据、写入智能体任务记录。当用户需要创建待办事项、查看任务列表、跟踪任务进度、管理项目清单或给他人分配任务、为任务上传附件文件、注册注销任务智能体、更新智能体主页数据、写入任务记录时使用。SkillsJul 2026
- lark-attendance飞书考勤打卡：查询自己的考勤打卡记录SkillsJul 2026
- lark-apps妙搭（Spark/Miaoda）应用开发与托管：应用创建、本地全栈开发、云端生成迭代、创意设计（UI mockup / 可交互原型 / 线框图 / 落地页 / 仪表盘 / 幻灯片 deck / 视觉探索）、AI相关能力和飞书平台能力或者其他外部能力集成、日志/Trace/监控指标/PV/UV 查询、环境变量管理、应用角色与成员管理、自动化触发器（定时/记录变更/Webhook/飞书审批）。当用户要SkillsJul 2026
