
Notion ReadOnly MCP Server

2025.04.30
2
TypeScriptNotion APIAI助手优化只读服务内容生成开发效率
Notion ReadOnly MCP Server 是一个专为AI助手优化的只读Notion API服务,专注于高效查询和检索Notion内容。其核心功能包括只读设计、最小化工具集、并行处理、扩展数据库访问以及针对AI助手的优化。适用于需要安全访问Notion内容并进行高效数据检索的场景,特别是AI助手如Cursor和Claude等。
View on GitHub
Overview
基本能力
产品定位
Notion ReadOnly MCP Server 是一个专为AI助手优化的只读Notion API服务,专注于高效查询和检索Notion内容。
核心功能
- 只读设计:专注于数据检索操作,确保对Notion内容的安全访问。
- 最小化工具集:将Notion API工具从15+减少到仅6个用于文档分析的基本工具。
- 并行处理:通过异步和并行API请求检索块内容,显著减少响应时间。
- 扩展数据库访问:支持数据库、页面属性和评论检索操作。
- 针对AI助手的优化:减少工具数量,解决AI助手中“工具过多可能降低性能”的问题。
适用场景
- AI助手需要安全访问Notion内容并进行高效数据检索的场景。
- 需要快速获取Notion页面、数据库、评论和属性信息的场景。
- 在AI助手如Cursor和Claude等中集成Notion内容的场景。
工具列表
API-retrieve-a-page
:获取页面信息。API-get-block-children
:获取页面内容块(并行处理)。API-retrieve-a-block
:获取特定块的详细信息。API-retrieve-a-database
:获取数据库信息。API-retrieve-a-comment
:获取页面或块的评论。API-retrieve-a-page-property
:获取页面的特定属性信息。API-get-one-pager
:递归检索完整的Notion页面及其所有块、数据库和相关内容。
常见问题解答
- 安全性:虽然只读操作风险较低,但仍建议配置集成的“能力”以进一步限制访问。
- 性能优化:通过减少工具数量和并行处理,显著提高响应速度和性能。
- AI助手兼容性:减少工具数量有助于在AI助手中保持高性能和准确性。
使用教程
使用依赖
- 在Notion中设置集成:访问https://www.notion.so/profile/integrations,创建或选择现有的内部集成。
- 配置集成的“能力”为“只读内容”以增强安全性。
安装教程
使用npm
在.cursor/mcp.json
或claude_desktop_config.json
中添加以下配置:
{
"mcpServers": {
"notionApi": {
"command": "npx",
"args": ["-y", "notion-readonly-mcp-server"],
"env": {
"OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer ntn_****\", \"Notion-Version\": \"2022-06-28\" }"
}
}
}
}
使用Docker
在.cursor/mcp.json
或claude_desktop_config.json
中添加以下配置:
{
"mcpServers": {
"notionApi": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"-e", "OPENAPI_MCP_HEADERS",
"taewoong1378/notion-readonly-mcp-server"
],
"env": {
"OPENAPI_MCP_HEADERS": "{\"Authorization\":\"Bearer ntn_****\",\"Notion-Version\":\"2022-06-28\"}"
}
}
}
}
调试方式
- 构建:
pnpm build
- 执行:
pnpm dev