15 支持
1 部分支持
4 不支持
- ·官方 MCP server 覆盖页面/数据库/Block 完整 CRUD
- ·notion-mcp 官方维护,配置简单
- ·社区 CLI 有限,复杂查询建议走 MCP
- ·API 速率限制需注意(3 req/s)
功能覆盖矩阵
页面管理
5/6 支持 支持 创建页面
命令
mcp call notion.pages.create parent='{"database_id":"xxx"}' properties='{"Name":{"title":[{"text":{"content":"新页面"}}]}}' 输入参数
parent: 父级(database_id 或 page_id) properties: 页面属性(title 必填)
示例输出
{ "id": "page_xxx", "url": "https://notion.so/xxx" } 支持 读取页面内容
命令
mcp call notion.blocks.children.list block_id=page_xxx
示例输出
{
"results": [
{ "type": "paragraph", "paragraph": { "rich_text": [{ "plain_text": "正文内容" }] } }
]
}
备注:返回块列表,需递归读取嵌套块
支持 追加内容块
命令
mcp call notion.blocks.children.append block_id=page_xxx children='[{"paragraph":{"rich_text":[{"text":{"content":"新内容"}}]}}]' 示例输出
{ "results": [...] } 备注:支持 paragraph / heading / bulleted_list / code / image 等所有块类型
支持 修改页面标题
命令
mcp call notion.pages.update page_id=page_xxx properties='{"Name":{"title":[{"text":{"content":"新标题"}}]}}' 示例输出
{ "id": "page_xxx", "url": "https://notion.so/xxx" } 支持 归档(删除)页面
命令
mcp call notion.pages.update page_id=page_xxx archived=true
示例输出
{ "id": "page_xxx", "archived": true } 备注:Notion 无永久删除 API,archived=true 相当于移入回收站
不支持 移动页面到其他父级
Gap:Notion API 不支持修改页面的 parent,只能重新创建
数据库
5/6 支持 支持 创建数据库
命令
mcp call notion.databases.create parent='{"page_id":"page_xxx"}' title='[{"text":{"content":"项目追踪"}}]' properties='{"Name":{"title":{}},"状态":{"select":{"options":[{"name":"进行中","color":"blue"}]}}}' 示例输出
{ "id": "db_xxx", "url": "https://notion.so/xxx" } 支持 查询数据库记录
命令
mcp call notion.databases.query database_id=db_xxx filter='{"property":"状态","select":{"equals":"进行中"}}' sorts='[{"property":"Name","direction":"ascending"}]' 输入参数
database_id: 数据库 ID filter: 过滤条件(支持 and/or 组合) sorts: 排序规则
示例输出
{ "results": [...], "has_more": false } 支持 添加数据库行(创建页面)
命令
mcp call notion.pages.create parent='{"database_id":"db_xxx"}' properties='{"Name":{"title":[{"text":{"content":"Task A"}}]},"状态":{"select":{"name":"进行中"}}}' 示例输出
{ "id": "page_yyy", "url": "https://notion.so/yyy" } 支持 更新数据库行属性
命令
mcp call notion.pages.update page_id=page_yyy properties='{"状态":{"select":{"name":"已完成"}}}' 示例输出
{ "id": "page_yyy" } 支持 获取数据库字段结构
命令
mcp call notion.databases.retrieve database_id=db_xxx
示例输出
{ "properties": { "Name": { "type": "title" }, "状态": { "type": "select", "select": { "options": [...] } } } } 不支持 创建汇总/公式字段
Gap:Rollup 和 Formula 字段只能通过 GUI 配置,API 不支持创建
搜索
2/4 支持 支持 全文搜索页面和数据库
命令
mcp call notion.search query='OKR 2026' filter='{"value":"page","property":"object"}' 输入参数
query: 搜索关键词 filter.value: "page" 或 "database"
示例输出
{
"results": [
{ "id": "page_xxx", "url": "https://notion.so/xxx", "properties": { "Name": {...} } }
]
}
支持 只搜索数据库
命令
mcp call notion.search query='项目' filter='{"value":"database","property":"object"}' 示例输出
{ "results": [...] } 部分支持 按创建/修改时间过滤
备注:databases.query 支持 last_edited_time 过滤,search 接口不支持
Gap:search 接口无时间范围参数,只能在数据库查询时用
不支持 语义搜索(AI 相关搜索)
Gap:Notion AI 搜索仅 GUI,API 未开放语义检索接口
评论
3/4 支持 支持 添加评论
命令
mcp call notion.comments.create parent='{"page_id":"page_xxx"}' rich_text='[{"text":{"content":"LGTM!"}}]' 示例输出
{ "id": "comment_xxx", "created_time": "..." } 支持 获取页面评论列表
命令
mcp call notion.comments.list block_id=page_xxx
示例输出
{ "results": [{ "id": "comment_xxx", "rich_text": [...] }] } 支持 回复评论(在 discussion 线程)
命令
mcp call notion.comments.create parent='{"page_id":"page_xxx"}' discussion_id=disc_xxx rich_text='[{"text":{"content":"已修复"}}]' 示例输出
{ "id": "comment_yyy" } 不支持 标记评论为已解决
Gap:Notion API 暂不支持解决/关闭评论,仅 GUI 支持
Gap 总结 (5 个功能缺口)
不支持
页面管理 › 移动页面到其他父级
Notion API 不支持修改页面的 parent,只能重新创建
不支持
数据库 › 创建汇总/公式字段
Rollup 和 Formula 字段只能通过 GUI 配置,API 不支持创建
部分
搜索 › 按创建/修改时间过滤
search 接口无时间范围参数,只能在数据库查询时用
不支持
搜索 › 语义搜索(AI 相关搜索)
Notion AI 搜索仅 GUI,API 未开放语义检索接口
不支持
评论 › 标记评论为已解决
Notion API 暂不支持解决/关闭评论,仅 GUI 支持