notion

Name: notion
Author: SafeAI-Lab-X

1.0kstars58forks

How to install notion?

safeai-lab-x/clawkeeper/notion

$npx -y skills add SafeAI-Lab-X/ClawKeeper --skill notion

Installs into the current project.

Summary

Notion API for creating and managing pages, databases, and blocks.

Files · 1

View on GitHub

SKILL.md

1	# notion
2
3	Use the Notion API to create/read/update pages, data sources (databases), and blocks.
4
5	## Setup
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:
10
11	```bash
12	mkdir -p ~/.config/notion
13	echo "ntn_your_key_here" > ~/.config/notion/api_key
14	```
15
16	4. Share target pages/databases with your integration (click "..." → "Connect to" → your integration name)
17
18	## API Basics
19
20	All requests need:
21
22	```bash
23	NOTION_KEY=$(cat ~/.config/notion/api_key)
24	curl -X GET "https://api.notion.com/v1/..." \
25	-H "Authorization: Bearer $NOTION_KEY" \
26	-H "Notion-Version: 2025-09-03" \
27	-H "Content-Type: application/json"
28	```
29
30	> Note: The `Notion-Version` header is required. This skill uses `2025-09-03` (latest). In this version, databases are called "data sources" in the API.
31
32	## Common Operations
33
34	Search for pages and data sources:
35
36	```bash
37	curl -X POST "https://api.notion.com/v1/search" \
38	-H "Authorization: Bearer $NOTION_KEY" \
39	-H "Notion-Version: 2025-09-03" \
40	-H "Content-Type: application/json" \
41	-d '{"query": "page title"}'
42	```
43
44	Get page:
45
46	```bash
47	curl "https://api.notion.com/v1/pages/{page_id}" \
48	-H "Authorization: Bearer $NOTION_KEY" \
49	-H "Notion-Version: 2025-09-03"
50	```
51
52	Get page content (blocks):
53
54	```bash
55	curl "https://api.notion.com/v1/blocks/{page_id}/children" \
56	-H "Authorization: Bearer $NOTION_KEY" \
57	-H "Notion-Version: 2025-09-03"
58	```
59
60	Create page in a data source:
61
62	```bash
63	curl -X POST "https://api.notion.com/v1/pages" \
64	-H "Authorization: Bearer $NOTION_KEY" \
65	-H "Notion-Version: 2025-09-03" \
66	-H "Content-Type: application/json" \
67	-d '{
68	"parent": {"database_id": "xxx"},
69	"properties": {
70	"Name": {"title": [{"text": {"content": "New Item"}}]},
71	"Status": {"select": {"name": "Todo"}}
72	}
73	}'
74	```
75
76	Query a data source (database):
77
78	```bash
79	curl -X POST "https://api.notion.com/v1/data_sources/{data_source_id}/query" \
80	-H "Authorization: Bearer $NOTION_KEY" \
81	-H "Notion-Version: 2025-09-03" \
82	-H "Content-Type: application/json" \
83	-d '{
84	"filter": {"property": "Status", "select": {"equals": "Active"}},
85	"sorts": [{"property": "Date", "direction": "descending"}]
86	}'
87	```
88
89	Create a data source (database):
90
91	```bash
92	curl -X POST "https://api.notion.com/v1/data_sources" \
93	-H "Authorization: Bearer $NOTION_KEY" \
94	-H "Notion-Version: 2025-09-03" \
95	-H "Content-Type: application/json" \
96	-d '{
97	"parent": {"page_id": "xxx"},
98	"title": [{"text": {"content": "My Database"}}],
99	"properties": {
100	"Name": {"title": {}},
101	"Status": {"select": {"options": [{"name": "Todo"}, {"name": "Done"}]}},
102	"Date": {"date": {}}
103	}
104	}'
105	```
106
107	Update page properties:
108
109	```bash
110	curl -X PATCH "https://api.notion.com/v1/pages/{page_id}" \
111	-H "Authorization: Bearer $NOTION_KEY" \
112	-H "Notion-Version: 2025-09-03" \
113	-H "Content-Type: application/json" \
114	-d '{"properties": {"Status": {"select": {"name": "Done"}}}}'
115	```
116
117	Add blocks to page:
118
119	```bash
120	curl -X PATCH "https://api.notion.com/v1/blocks/{page_id}/children" \
121	-H "Authorization: Bearer $NOTION_KEY" \
122	-H "Notion-Version: 2025-09-03" \
123	-H "Content-Type: application/json" \
124	-d '{
125	"children": [
126	{"object": "block", "type": "paragraph", "paragraph": {"rich_text": [{"text": {"content": "Hello"}}]}}
127	]
128	}'
129	```
130
131	## Property Types
132
133	Common property formats for database items:
134
135	- Title: `{"title": [{"text": {"content": "..."}}]}`
136	- Rich text: `{"rich_text": [{"text": {"content": "..."}}]}`
137	- Select: `{"select": {"name": "Option"}}`
138	- Multi-select: `{"multi_select": [{"name": "A"}, {"name": "B"}]}`
139	- Date: `{"date": {"start": "2024-01-15", "end": "2024-01-16"}}`
140	- Checkbox: `{"checkbox": true}`
141	- Number: `{"number": 42}`
142	- URL: `{"url": "https://..."}`
143	- Email: `{"email": "a@b.com"}`
144	- Relation: `{"relation": [{"id": "page_id"}]}`
145
146	## Key Differences in 2025-09-03
147
148	- Databases → Data Sources: Use `/data_sources/` endpoints for queries and retrieval
149	- Two IDs: Each database now has both a `database_id` and a `data_source_id`
150	- Use `database_id` when creating pages (`parent: {"database_id": "..."}`)
151	- Use `data_source_id` when querying (`POST /v1/data_sources/{id}/query`)
152	- Search results: Databases return as `"object": "data_source"` with their `data_source_id`
153	- Parent in responses: Pages show `parent.data_source_id` alongside `parent.database_id`
154	- Finding the data_source_id: Search for the database, or call `GET /v1/data_sources/{data_source_id}`
155
156	## Notes
157
158	- Page/database IDs are UUIDs (with or without dashes)
159	- The API cannot set database view fil

People who liked this also viewed

6 picks

Type

lark-drive飞书云空间（云盘/云存储）：管理 Drive 文件和文件夹，包含上传/下载、创建文件夹、复制/移动/删除、查看元数据、评论/权限/订阅、标题、版本、飞书文档密级标签（secure labels）和本地文件导入。用户需要整理云盘目录、处理云空间资源 URL/token、判断链接类型/真实 token/标题，或导入 Word/Markdown/Excel/CSV/PPTX/.base 为 docx/sSkillsJul 2026382k16k
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 2026382k16k
lark-whiteboard飞书画板：查询和编辑飞书云文档中的画板。支持导出画板为预览图片、导出原始节点结构、使用多种格式更新画板内容。当用户需要查看画板内容、导出画板图片、编辑画板时使用此 skill。不负责：飞书云文档内容编辑（lark-doc）、文档内嵌电子表格/Base（lark-sheets / lark-base）。SkillsJul 2026380k16k
lark-task飞书任务：管理任务、清单和任务智能体。创建待办任务、查看和更新任务状态、拆分子任务、组织任务清单、分配协作成员、上传任务附件、注册或注销任务智能体、更新任务智能体的主页数据、写入智能体任务记录。当用户需要创建待办事项、查看任务列表、跟踪任务进度、管理项目清单或给他人分配任务、为任务上传附件文件、注册注销任务智能体、更新智能体主页数据、写入任务记录时使用。SkillsJul 2026380k16k
lark-attendance飞书考勤打卡：查询自己的考勤打卡记录SkillsJul 2026330k16k
lark-apps妙搭（Spark/Miaoda）应用开发与托管：应用创建、本地全栈开发、云端生成迭代、创意设计（UI mockup / 可交互原型 / 线框图 / 落地页 / 仪表盘 / 幻灯片 deck / 视觉探索）、AI相关能力和飞书平台能力或者其他外部能力集成、日志/Trace/监控指标/PV/UV 查询、环境变量管理、应用角色与成员管理、自动化触发器（定时/记录变更/Webhook/飞书审批）。当用户要SkillsJul 2026227k16k

notion

1.0kstars58forks

View on GitHub

How to install notion?

safeai-lab-x/clawkeeper/notion

$npx -y skills add SafeAI-Lab-X/ClawKeeper --skill notion

Installs into the current project.

Summary

Notion API for creating and managing pages, databases, and blocks.

Files · 1

View on GitHub

SKILL.md

1	# notion
2
3	Use the Notion API to create/read/update pages, data sources (databases), and blocks.
4
5	## Setup
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:
10
11	```bash
12	mkdir -p ~/.config/notion
13	echo "ntn_your_key_here" > ~/.config/notion/api_key
14	```
15
16	4. Share target pages/databases with your integration (click "..." → "Connect to" → your integration name)
17
18	## API Basics
19
20	All requests need:
21
22	```bash
23	NOTION_KEY=$(cat ~/.config/notion/api_key)
24	curl -X GET "https://api.notion.com/v1/..." \
25	-H "Authorization: Bearer $NOTION_KEY" \
26	-H "Notion-Version: 2025-09-03" \
27	-H "Content-Type: application/json"
28	```
29
30	> Note: The `Notion-Version` header is required. This skill uses `2025-09-03` (latest). In this version, databases are called "data sources" in the API.
31
32	## Common Operations
33
34	Search for pages and data sources:
35
36	```bash
37	curl -X POST "https://api.notion.com/v1/search" \
38	-H "Authorization: Bearer $NOTION_KEY" \
39	-H "Notion-Version: 2025-09-03" \
40	-H "Content-Type: application/json" \
41	-d '{"query": "page title"}'
42	```
43
44	Get page:
45
46	```bash
47	curl "https://api.notion.com/v1/pages/{page_id}" \
48	-H "Authorization: Bearer $NOTION_KEY" \
49	-H "Notion-Version: 2025-09-03"
50	```
51
52	Get page content (blocks):
53
54	```bash
55	curl "https://api.notion.com/v1/blocks/{page_id}/children" \
56	-H "Authorization: Bearer $NOTION_KEY" \
57	-H "Notion-Version: 2025-09-03"
58	```
59
60	Create page in a data source:
61
62	```bash
63	curl -X POST "https://api.notion.com/v1/pages" \
64	-H "Authorization: Bearer $NOTION_KEY" \
65	-H "Notion-Version: 2025-09-03" \
66	-H "Content-Type: application/json" \
67	-d '{
68	"parent": {"database_id": "xxx"},
69	"properties": {
70	"Name": {"title": [{"text": {"content": "New Item"}}]},
71	"Status": {"select": {"name": "Todo"}}
72	}
73	}'
74	```
75
76	Query a data source (database):
77
78	```bash
79	curl -X POST "https://api.notion.com/v1/data_sources/{data_source_id}/query" \
80	-H "Authorization: Bearer $NOTION_KEY" \
81	-H "Notion-Version: 2025-09-03" \
82	-H "Content-Type: application/json" \
83	-d '{
84	"filter": {"property": "Status", "select": {"equals": "Active"}},
85	"sorts": [{"property": "Date", "direction": "descending"}]
86	}'
87	```
88
89	Create a data source (database):
90
91	```bash
92	curl -X POST "https://api.notion.com/v1/data_sources" \
93	-H "Authorization: Bearer $NOTION_KEY" \
94	-H "Notion-Version: 2025-09-03" \
95	-H "Content-Type: application/json" \
96	-d '{
97	"parent": {"page_id": "xxx"},
98	"title": [{"text": {"content": "My Database"}}],
99	"properties": {
100	"Name": {"title": {}},
101	"Status": {"select": {"options": [{"name": "Todo"}, {"name": "Done"}]}},
102	"Date": {"date": {}}
103	}
104	}'
105	```
106
107	Update page properties:
108
109	```bash
110	curl -X PATCH "https://api.notion.com/v1/pages/{page_id}" \
111	-H "Authorization: Bearer $NOTION_KEY" \
112	-H "Notion-Version: 2025-09-03" \
113	-H "Content-Type: application/json" \
114	-d '{"properties": {"Status": {"select": {"name": "Done"}}}}'
115	```
116
117	Add blocks to page:
118
119	```bash
120	curl -X PATCH "https://api.notion.com/v1/blocks/{page_id}/children" \
121	-H "Authorization: Bearer $NOTION_KEY" \
122	-H "Notion-Version: 2025-09-03" \
123	-H "Content-Type: application/json" \
124	-d '{
125	"children": [
126	{"object": "block", "type": "paragraph", "paragraph": {"rich_text": [{"text": {"content": "Hello"}}]}}
127	]
128	}'
129	```
130
131	## Property Types
132
133	Common property formats for database items:
134
135	- Title: `{"title": [{"text": {"content": "..."}}]}`
136	- Rich text: `{"rich_text": [{"text": {"content": "..."}}]}`
137	- Select: `{"select": {"name": "Option"}}`
138	- Multi-select: `{"multi_select": [{"name": "A"}, {"name": "B"}]}`
139	- Date: `{"date": {"start": "2024-01-15", "end": "2024-01-16"}}`
140	- Checkbox: `{"checkbox": true}`
141	- Number: `{"number": 42}`
142	- URL: `{"url": "https://..."}`
143	- Email: `{"email": "a@b.com"}`
144	- Relation: `{"relation": [{"id": "page_id"}]}`
145
146	## Key Differences in 2025-09-03
147
148	- Databases → Data Sources: Use `/data_sources/` endpoints for queries and retrieval
149	- Two IDs: Each database now has both a `database_id` and a `data_source_id`
150	- Use `database_id` when creating pages (`parent: {"database_id": "..."}`)
151	- Use `data_source_id` when querying (`POST /v1/data_sources/{id}/query`)
152	- Search results: Databases return as `"object": "data_source"` with their `data_source_id`
153	- Parent in responses: Pages show `parent.data_source_id` alongside `parent.database_id`
154	- Finding the data_source_id: Search for the database, or call `GET /v1/data_sources/{data_source_id}`
155
156	## Notes
157
158	- Page/database IDs are UUIDs (with or without dashes)
159	- The API cannot set database view fil

People who liked this also viewed

6 picks

Type