Notion MCP Server

基本能力

产品定位

Notion MCP Server 是一个中间件服务，旨在为 AI 模型提供与 Notion 平台交互的能力，实现自动化文档管理和数据处理。

核心功能

• 页面操作：获取、更新和创建 Notion 页面
• 数据库操作：查询、创建、更新 Notion 数据库
• 块操作：获取、更新、列出、追加和删除 Notion 块
• 评论操作：创建和获取 Notion 评论
• 搜索操作：搜索 Notion 对象

适用场景

• AI 辅助的 Notion 文档管理
• 自动化 Notion 数据库操作
• 集成 Notion 到 AI 工作流中

工具列表

• Page Operations: get_page, update_page, create_page
• Database Operations: get_database, query_database, create_database, update_database
• Block Operations: get_block, update_block, list_blocks, append_blocks, delete_block
• Comment Operations: create_comment, get_comment
• Search Operations: search

常见问题解答

• "spawn uv ENOENT" Error: 需要确保 uv 可执行文件的路径正确配置
• 连接问题: 检查配置文件格式、路径和 Notion 集成权限

使用教程

使用依赖

• Python 3.12 或更高版本
• uv 包管理器

安装教程

# 克隆仓库
git clone https://github.com/flyer103/notion-mcp.git
cd notion-mcp

# 使用 uv 安装依赖
uv venv
source .venv/bin/activate
uv pip install -e ".[dev]"

配置

1. 在 Notion 集成页面 创建新集成
2. 设置 API 密钥环境变量:

export NOTION_API_KEY="your_api_key_here"

1. 在 Notion 页面中分享内容给集成

调试方式

标准输入/输出模式

python -m notion_mcp.server

SSE 模式

python -m notion_mcp.server --transport sse --host 0.0.0.0 --port 8000

验证配置

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

许可证

该项目遵循 Apache-2.0 开源许可条款，请参阅 Apache-2.0 了解完整条款。