notion-mcp
AI通过Markdown读写Notion的MCP服务
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：notion-mcp。 它的用途是：AI通过Markdown读写Notion的MCP服务 完整的 Skill 内容见：https://321skill.com/skills/notion-mcp/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“将这篇文章（附Markdown内容）保存到Notion的‘学习笔记’数据库，标签设为‘AI’和‘MCP’，并设置创建日期为今天。” 它会自动调用MCP工具，将Markdown转换为Notion页面，并正确映射数据库属性，无需手动处理JSON格式。
介绍
该Skill将Notion的复杂API封装为Markdown格式，让AI Agent通过42个MCP工具直接读写GitHub Flavored Markdown，无需手动构造Notion的JSON块结构。服务器自动处理块转换、数据库Schema映射、OAuth认证，并支持Redis可选的持久化缓存，适合多实例部署场景。
使用方式：在支持MCP协议的客户端（如Claude Code、Cursor）中配置该服务，即可通过自然语言指令让AI读取Notion页面内容、创建数据库条目、更新属性等。例如，输入“将这篇Markdown笔记添加到Notion项目数据库，状态设为‘进行中’”，AI会自动完成类型转换和属性映射。
适合频繁使用Notion管理知识库、项目文档、团队协作的开发者、产品经理和内容创作者。尤其适合需要让AI代理自动同步和更新Notion内容的场景，如自动化工作流、知识库维护、任务跟踪等。
使用建议：首次使用需创建Notion内部集成并获取API密钥，将页面共享给集成。若需OAuth支持，可启动HTTP传输模式。注意Redis为可选，即使未配置也能正常使用，但多实例环境下建议启用以提升Schema缓存和OAuth令牌持久化性能。
核心特点
同类MCP服务通常要求AI直接构造Notion的JSON块结构，出错率高；本服务以Markdown为中间格式，自动完成双向转换，显著降低AI的Token消耗和开发调试成本。
注意事项
不适合需要直接操作Notion高级API功能（如自定义块类型、复杂权限控制、完整数据库查询语法）的场景。
常见问题
如何获取Notion API密钥？
在Notion的“我的集成”页面创建内部集成，复制Secret Token，并将需要操作的页面或数据库共享给该集成。
支持哪些Notion块类型？
支持24种块类型，包括折叠、分栏、标注、表格、上传等，几乎覆盖Notion所有常用块。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/notion-mcp/raw/index.md 读取 notion-mcp 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/notion-mcp/raw/index.md（查看排版版本）