基本能力
产品定位
Notion API MCP 是一个连接 AI 模型与 Notion API 的中间件,旨在增强 Notion 的任务管理和内容组织能力。
核心功能
- 待办事项管理:创建、更新和跟踪任务,支持富文本、截止日期、优先级和嵌套子任务
- 数据库操作:创建和管理 Notion 数据库,支持自定义属性、过滤器和视图
- 内容组织:使用 Markdown 支持、层次列表和块操作来结构和格式化内容
- 实时集成:通过干净的异步实现直接与 Notion 的工作区、页面和数据库交互
适用场景
- AI 辅助的任务管理
- 自动化内容组织和格式化
- 与 Notion 数据库的编程交互
- 团队协作中的任务分配和跟踪
工具列表
- Notion API 集成工具:提供与 Notion API 的完整交互能力
- 任务管理工具:支持创建、更新和跟踪复杂任务
- 数据库管理工具:允许创建和管理自定义数据库
常见问题解答
- 如何获取 Notion API 密钥?
- 在 Notion 的集成页面创建新集成并复制内部集成令牌
- 如何设置父页面或现有数据库?
- 父页面用于创建新数据库,现有数据库 ID 用于操作已有数据库
- Claude Desktop 如何配置?
- 需要在 Claude Desktop 的配置文件中添加 MCP 服务器详细信息
使用教程
使用依赖
- Python 环境
- Notion 账户和集成权限
安装教程
```bash
克隆和设置
git clone https://github.com/yourusername/notion-api-mcp.git
cd notion-api-mcp
uv venv && source .venv/bin/activate
安装和配置
uv pip install -e .
cp .env.integration.template .env
在 .env 中添加您的 Notion 凭据
NOTION_API_KEY=ntn_your_integration_token_here
NOTION_PARENT_PAGE_ID=your_page_id_here
NOTION_DATABASE_ID=your_database_id_here
运行服务器
python -m notion_api_mcp
```
调试方式
```bash
设置 PYTHONPATH 并运行
PYTHONPATH=/path/to/project python -m notion_api_mcp
查看日志输出
控制台输出用于开发
文件日志用于服务运行
详细的错误信息和请求/响应日志
```