Notion 服务桥
一座桥梁，连接了Claude AI和Notion，使用户能够通过自然语言与Notion数据库和页面进行交互，支持创建、读取、更新和删除内容等操作。
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"mcp-notion-server": {
"args": [
"-y",
"@gabornyerges/mcp-notion-server"
],
"command": "npx",
"env": {
"NOTION_API_KEY": "your-notion-api-key"
}
}
}
}该服务需要配置环境变量：NOTION_API_KEY
可用工具 （10 个）
该服务在 MCP 协议中暴露的工具，AI 可按需调用
list_databases
List all accessible databases
该工具无需必填参数，直接调用即可
create_database 3 个参数 需填 3 项
Create a new database
必填参数：parent_id、title、properties
create_page 5 个参数 需填 2 项
Create a new page
必填参数：parent_type、parent_id
update_page 2 个参数 需填 2 项
Update an existing page
必填参数：page_id、properties
append_blocks 2 个参数 需填 2 项
Append blocks to a page
必填参数：page_id、blocks
delete_blocks 1 个参数 需填 1 项
Delete blocks from a page
必填参数：block_id
get_page 1 个参数 需填 1 项
Retrieve a page by ID
必填参数：page_id
get_database 1 个参数 需填 1 项
Retrieve a database by ID
必填参数：database_id
query_database 5 个参数 需填 1 项
Query a database with filters and sorting
必填参数：database_id
search 5 个参数 需填 1 项
Search pages and databases
必填参数：query
服务介绍
mcp-notion-server
一个用于 Notion 集成的 Model Context Protocol 服务器
这个基于 TypeScript 的 MCP 服务器实现了 Claude 和 Notion 之间的桥梁，允许无缝地与 Notion 的数据库和页面进行交互。它通过以下方式展示了核心的 MCP 概念：
- Notion 页面和数据库的资源管理
- 对 Notion 内容进行 CRUD 操作的工具
- 由 AI 支持的内容分析提示
功能
资源
- 通过 URI 访问 Notion 页面和数据库
- 支持纯文本和富文本内容类型
- 从 Notion 属性中提取元数据
工具
数据库操作
list_databases- 列出所有可访问的 Notion 数据库create_database- 使用自定义属性创建新数据库query_database- 搜索和过滤数据库条目update_database- 修改数据库属性和架构
页面操作
create_page- 在数据库中或作为子页面创建新页面- 支持标题、属性和 markdown 内容
update_page- 更新现有页面属性get_page- 检索页面内容和元数据delete_page- 从数据库或父页面中删除页面
块操作
append_blocks- 向页面添加新的块delete_blocks- 从页面中移除块get_blocks- 检索块内容update_blocks- 修改现有块内容
提示
summarize_notes- 生成笔记的简洁摘要analyze_content- 提供对页面内容的见解和分析suggest_tags- 根据内容推荐相关标签
设置
先决条件
- Node.js 18 或更高版本
- Notion API 密钥和集成设置
- Claude Desktop 应用程序
与 Claude Desktop 集成
创建一个 Notion 集成：
- 访问 Notion 你的集成页面。
- 点击“新建集成”。
- 为您的集成命名并选择适当的权限（例如，“读取内容”，“更新内容”）。
- 获取密钥：
- 从您的集成中复制“内部集成令牌”。
这个令牌将用于身份验证。 - 将集成添加到您的工作区：
- 在 Notion 中打开您希望集成访问的页面或数据库。
- 点击右上角的导航按钮。
- 点击“连接到”按钮并选择您的集成。
配置设置
将服务器配置添加到 Claude Desktop：
MacOS:
~/Library/Application Support/Claude/claude_desktop_config.json
Windows:
%APPDATA%/Claude/claude_desktop_config.json
配置内容：
{
"mcpServers": {
"mcp-notion-server": {
"command": "npx",
"args": [
"-y",
"@gabornyerges/mcp-notion-server"
],
"env": {
"NOTION_API_KEY": "your-notion-api-key"
}
}
}
}
调试
由于 MCP 服务器通过 stdio 进行通信，调试可能会比较困难。我们建议使用 MCP Inspector，它作为一个包脚本提供：
- MCP Inspector
npm run inspector
MIT 许可证 - 查看 LICENSE 获取详细信息
