Notion MCP Server

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

  1. 访问 Notion Integrations
  2. 创建新集成并复制令牌
  3. 将令牌添加到 .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 仓库