fastNotion MCP：让 AI 助手直接操控 Notion 的开源连接器

fastNotion MCP 是一个基于 fastMCP 框架打造的 Notion 连接器，让 AI 助手（如 Trae、Cursor、Claude 等）能够直接操控 Notion 数据库。它支持查询、创建和更新 Notion 页面，让 AI 成果可以一键归档到 Notion 中，实现知识管理的自动化。

项目简介

fastNotion MCP 是一个开源的 Python 项目，由 whjwjx 开发维护。截至目前，该项目在 GitHub 上已获得 5 stars，主要使用 Python 编写，采用 Apache-2.0 许可证。

该项目的核心价值在于：让 AI 助手能够真正"读懂"并"操作" Notion，就像给 AI 装了一个 Notion 专用插件。无论是代码复盘、工作日志还是 AI 总结出的干货，都可以快速归档到 Notion 中。

核心特性

AI 灵感落库

解决痛点：代码复盘、工作日志、AI 总结出的干货难以快速归档。 解决方案：一键直连 Notion，无需手动搬运，让 AI 成果瞬间转化为结构化知识。

Schema 自适应

解决痛点：数据库字段名改了、属性变了？传统工具容易报错失效。 解决方案：智能识别标题与属性，优先推荐使用英文属性名以获得最佳稳定性。

API 稳如磐石

解决痛点：Notion API 版本迭代快，请求参数复杂，老代码动不动就挂。 解决方案：内置 API 智能路由，完美支持中英文双语环境，告别 400 报错。

技术栈

• Python - 核心编程语言
• fastMCP - Model Context Protocol 框架
• Notion API - Notion 官方 API 接口

安装指南

前置要求

• Python >= 3.8
• pip 包管理器

安装步骤

1. 克隆仓库

git clone https://github.com/whjwjx/notionMCP.git
cd notionMCP

2. 安装依赖

pip install -r requirements.txt

3. 配置 Notion 凭证

在项目根目录创建 .env 文件：

# 必填：Notion 机器人 Integration Token
NOTION_TOKEN=your_integration_token_here

# 必填：目标数据库 ID
DATABASE_ID=your_database_id_here

4. 本地验证

python notion_mcp.py

IDE 接入配置

Trae 本地部署配置

{
  "mcpServers": {
    "notion-mcp-local": {
      "command": "python",
      "args": ["<您的项目绝对路径>\\notion_mcp.py"],
      "workingDirectory": "<您的项目绝对路径>",
      "transport": "stdio"
    }
  }
}

云端部署接入

支持 FastMCP Cloud 云端部署，配置方式请参考官方文档。

使用示例

查询数据库结构

指令：帮我查一下 Notion 数据库 <您的数据库ID> 的结构信息

调用工具：get_database_info(database_id="...")

搜索页面

指令：在数据库 <您的数据库ID> 中搜一下标题包含"测试"的页面

调用工具：query_database(database_id="...", filter_params={...})

创建页面

指令：在数据库 <您的数据库ID> 中新建页面，标题"今日代码提交"，内容"完成 MCP 接口封装"

调用工具：create_notion_page(database_id="...", title="...", content="...")

更新页面

指令：更新 Notion 页面 <您的页面ID> 的内容为"测试更新功能成功"

调用工具：update_notion_page(page_id="...", content="...")

项目架构

.
├── notion_mcp.py      # 核心：MCP 服务入口与工具定义
├── notion_demo.py     # 底层：Notion API 请求封装引擎
├── requirements.txt   # 依赖：项目运行环境清单
├── features.md        # 文档：全量功能支持手册
└── bug_fixes.md       # 记录：已知问题修复路线图

项目链接

• GitHub 仓库：https://github.com/whjwjx/fastNotionMCP
• Topics：mcp, trae, cursor, notion