返回 MCP 首页

Notion

@ 社区模板

提供 Notion API 的 MCP 服务器,使 LLM 能够与 Notion 工作区进行交互
Notion
社区 MCP
文档

Notion 服务 MCP 接入

通过 MCP 协议提供 Notion API 服务调用,使 LLM 能够与 Notion 工作区进行交互。此外,它采用 Markdown 转换来减少与 LLMs 通信时的上下文大小,优化令牌使用,使交互更加高效。

前往云开发平台 MCP Server


环境变量

  • 需要将 NOTION_API_TOKEN 配置为您在 Notion 上创建的 API integration token
  • 可选配置 NOTION_MARKDOWN_CONVERSION,设置为“true”以启用实验性的 Markdown 转换。这可以显著减少查看内容时的令牌消耗,但在尝试编辑页面内容时可能会导致问题

🗺️ 功能清单

工具标识功能描述核心参数
notion_append_block_children追加子区块到目标父区块block_id, children
notion_retrieve_block获取指定区块的详细信息block_id
notion_retrieve_block_children获取父区块的子区块列表block_id, start_cursor, page_size
notion_delete_block删除指定区块block_id
notion_retrieve_page获取指定页面的详细信息page_id
notion_update_page_properties更新页面属性page_id, properties
notion_create_database创建数据库parent, properties, title
notion_query_database查询数据库中的记录database_id, filter, sorts, start_cursor, page_size
notion_retrieve_database获取指定数据库的详细信息database_id
notion_update_database更新数据库信息database_id, title, description, properties
notion_create_database_item在数据库中创建新条目database_id, properties
notion_search搜索页面或数据库query, filter, sort, start_cursor, page_size
notion_list_all_users列出工作区中的所有用户(企业版功能)start_cursor, page_size
notion_retrieve_user获取指定用户的详细信息(企业版功能)user_id
notion_retrieve_bot_user获取机器人用户的信息
notion_create_comment创建评论rich_text, parent, discussion_id
notion_retrieve_comments获取与区块或页面相关的评论列表block_id, start_cursor, page_size

仓库地址

https://github.com/suekou/mcp-notion-server/tree/main


🔌 使用方式


云开发 MCP 控制台

参数说明

1. notion_append_block_children

参数名称描述参数类型参数描述
block_id目标父区块IDstring需要追加子区块的父区块标识符
children子区块对象列表array要追加的区块对象数组(遵循Notion Block Object规范)

返回: 有关附加块的信息

2. notion_retrieve_block

参数名称描述参数类型参数描述
block_id目标区块IDstring需要获取信息的区块标识符

返回: 有关该区块的详细信息

3. notion_retrieve_block_children

参数名称描述参数类型参数描述
block_id父区块IDstring需要获取子列表的父区块标识符
start_cursor分页起始位置string可选,分页查询起始游标(来自前一次响应)
page_size返回数量限制number可选,单次请求最大返回数量(默认100,最大值100)

返回: 子块列表

4. notion_delete_block

参数名称描述参数类型参数描述
block_id待删除区块IDstring需要删除的区块标识符

返回: 删除确认

5. notion_retrieve_page

参数名称描述参数类型参数描述
page_id目标页面IDstring需要获取详细信息的页面标识符

返回: 关于页面的详细信息

6. notion_update_page_properties

参数名称描述参数类型参数描述
page_id目标页面IDstring需要更新的页面标识符
properties更新属性对象object包含需要更新的属性键值对(遵循Notion Properties规范)

返回: 有关更新页面的信息

7. notion_create_database

参数名称描述参数类型参数描述
parent父对象信息object数据库的父级对象(需包含page_id或workspace信息)
properties属性结构定义object数据库的字段类型定义
title数据库标题array可选,标题富文本数组

返回: 有关创建的数据库的信息

8. notion_query_database

参数名称描述参数类型参数描述
database_id目标数据库IDstring需要查询的数据库标识符
filter过滤条件object可选,查询过滤条件
sorts排序规则array可选,结果排序规则数组
start_cursor分页起始位置string可选,分页查询起始游标
page_size返回数量限制number可选,单次请求最大返回数量(默认100,最大值100)

返回: 查询结果列表

9. notion_retrieve_database

参数名称描述参数类型参数描述
database_id目标数据库IDstring需要获取信息的数据库标识符

返回: 关于数据库的详细信息

10. notion_update_database

参数名称描述参数类型参数描述
database_id目标数据库IDstring需要更新的数据库标识符
title新标题array可选,标题数组
description新描述array可选,描述数组
properties更新属性架构object可选,新的属性字段定义

返回: 有关更新数据库的信息

11. notion_create_database_item

参数名称描述参数类型参数描述
database_id目标数据库IDstring需要添加条目的数据库标识符
properties条目属性值object必须匹配数据库结构的属性

返回: 有关新创建数据库项的信息

参数名称描述参数类型参数描述
query搜索关键词string可选,在标题中搜索的关键词
filter结果类型过滤object可选,限制结果为pages/databases(默认返回全部)
sort排序规则object可选,结果排序规则
start_cursor分页起始位置string可选,分页查询起始游标
page_size返回数量限制number可选,单次请求最大返回数量(默认100,最大值100)

返回: 匹配页面或数据库的列表

13. notion_list_all_users

此功能需要升级到 Notion 企业计划,并使用组织 API 密钥以避免权限错误

参数名称描述参数类型参数描述
start_cursor分页起始位置string可选,分页查询起始游标
page_size返回数量限制number可选,单次请求最大返回数量(最大值100)

返回: 工作区中所有用户的分页列表

14. notion_retrieve_user

此功能需要升级到 Notion 企业计划,并使用组织 API 密钥以避免权限错误

参数名称描述参数类型参数描述
user_id目标用户IDstring需要获取信息的用户标识符

返回: 关于指定用户的详细信息

15. notion_retrieve_bot_user

返回: 关于机器人用户的信息,包括授权集成的人的详细信息

16. notion_create_comment

参数名称描述参数类型参数描述
rich_text评论内容array富文本内容数组(包含text对象)
parent关联页面object可选,必须包含page_id(与discussion_id二选一)
discussion_id讨论IDstring可选,现有讨论标识符

返回: 有关创建的评论的信息

17. notion_retrieve_comments

参数名称描述参数类型参数描述
block_id目标区块/页面IDstring需要获取评论的区块或页面标识符
start_cursor分页起始位置string可选,分页查询起始游标
page_size返回数量限制number可选,单次请求最大返回数量(最大值100)

返回: 与指定块或页面相关的评论的分页列表