Notion MCP Server
为Notion集成提供的模型上下文协议(MCP)服务器实现,提供了一个与Notion的API交互的标准接口。
概述
Notion MCP 是一个与 Notion 集成的 Model Context Protocol 服务器,提供标准化接口以便与 Notion API 交互。
快速安装
# 1. 克隆仓库
git clone https://github.com/ccabanillas/notion-mcp.git
cd notion-mcp
# 2. 设置环境
python -m venv venv
source venv/bin/activate # Windows: venvScriptsactivate
pip install -e .
# 3. 创建环境变量
echo "NOTION_API_KEY=你的Notion集成令牌" > .env
配置 Notion
- 访问 Notion Integrations
- 创建新集成并复制令牌
- 将令牌添加到
.env
文件中
基本使用
测试服务器
python -m notion_mcp
配置 Claude Desktop
在 claude_desktop_config.json
中添加:
"notion-mcp": {
"command": "/path/to/your/venv/bin/python3",
"args": ["-m", "notion_mcp"],
"cwd": "/path/to/your/notion-mcp"
}
主要功能
- 查询 Notion 数据库
- 创建和更新页面
- 全工作区搜索
- 异步支持
- 类型安全(基于 Pydantic)
项目结构
notion-mcp/
├── src/notion_mcp/
│ ├── models/
│ ├── client.py
│ └── server.py
└── .env
许可证
MIT 许可证
详细文档请参阅 GitHub 仓库