Notion MCP Server

基本能力

产品定位

Notion MCP Server 是一个为 Notion 集成设计的 Model Context Protocol (MCP) 服务器实现，提供了与 Notion API 交互的标准化接口。

核心功能

• 列出和查询 Notion 数据库
• 创建和更新页面
• 搜索 Notion 工作空间
• 完整的异步/等待支持
• 类型安全的 Pydantic 模型
• 适当的错误处理

适用场景

• 与 Claude Desktop 集成使用
• 自动化 Notion 工作流程
• 开发与 Notion 集成的应用程序

工具列表

• notion_mcp: 主服务器模块，提供与 Notion API 的交互功能
• client.py: 客户端模块，用于与服务器通信
• server.py: 服务器模块，处理请求和响应

常见问题解答

• 如何获取 Notion 集成令牌？
• 访问 https://www.notion.so/my-integrations
• 创建一个新的集成
• 复制集成令牌
• 将其添加到 .env 文件中

使用教程

使用依赖

1. 确保已安装 Python 和 Git

安装教程

1. 克隆仓库:

git clone https://github.com/ccabanillas/notion-mcp.git
cd notion-mcp

1. 创建虚拟环境并安装依赖:

python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -e .

1. 在项目根目录创建 .env 文件:

NOTION_API_KEY=your_notion_integration_token

调试方式

1. 测试服务器(应该无错误运行):

python -m notion_mcp

1. 要与 Claude Desktop 一起使用，需要调整 claude_desktop_config.json 文件:

"notion-mcp": {
    "command": "/Users/username/Projects/notion-mcp/venv/bin/python3",
    "args": ["-m", "notion_mcp"],
    "cwd": "/Users/username/Projects/notion-mcp"
},

许可证

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