Notion Full MCP

概念完整mcp

功能齐全的Notion MCP服务器，具有深度页面读取、手术块编辑、快照/还原、文件上传（Notion托管的图像和PDF）、表行操作、从垃圾箱中还原页面、跨父级的破坏性页面复制以及包括表在内的所有块类型。

v0.3.0的新增功能

• 从回收站还原页面。 restore_page 通过发送来显式取消存档页面 archived=False。这是与 delete_block 在一个页面上，围绕故意安全防护工作 update_page 这阻碍了 archived=False。还原父级时，级联子档案会自动还原。
• 父母之间的破坏性页面复制。 copy_page_to_parent 是Notion的公共API不支持父级更改的解决方法。在目标父级上使用相同的标题、图标和内容重新创建页面，然后存档原始页面。处理段落、标题、列表、表格、分隔符、代码块和图像/文件块。如果源已嵌套，则拒绝运行 child_page 后代（手动复制）。
• move_page 已弃用，现在加薪。 概念 PATCH /pages/{id} 端点默默地忽略父字段的更改——调用返回HTTP 200，但什么也不做。这 move_page 工具现在返回一个明确的错误，将调用者指向 copy_page_to_parent 或者在Notion侧栏中手动拖放。

v0.2.0的新增功能

• 通知文件上传。 将图像和文件直接上传到Notion自己的工作区存储，而不是依赖imgur等外部主机。适用于PNG、JPEG、SVG、GIF、PDF和任何其他Notion支持的附件类型。
• 图像块助手。 upload_image_as_block 上传一个文件并将其插入到一个调用中的某个位置。 replace_image_block 交换现有图像的内容，同时保留其在父图像中的位置。 download_image_block 将任何图像块的文件拉到磁盘。
• 表行操作。 insert_table_row 通过自动宽度验证向现有表添加行。 update_table_cell 替换单个单元格的文本。不再为小编辑重建整个表格。

安装

pip install notion-full-mcp
# or
uv pip install notion-full-mcp

快速开始

export NOTION_API_TOKEN="your-token-here"
notion-mcp

Claude代码集成

添加 ~/.claude.json 在...之下 mcpServers:

{
  "notion-full": {
    "type": "stdio",
    "command": "uvx",
    "args": ["notion-full-mcp"],
    "env": {
      "NOTION_API_TOKEN": "your-token-here"
    }
  }
}

或者为了当地发展：

{
  "notion-full": {
    "type": "stdio",
    "command": "uv",
    "args": ["run", "--directory", "/path/to/notion-full-mcp", "notion-mcp"],
    "env": {
      "NOTION_API_TOKEN": "your-token-here"
    }
  }
}

工具（33）

搜索和页面

阅读

编辑

插入

删除

评论

数据库

用户

快照/还原

媒体和文件

表格

通知API令牌

1. 首选 https://www.notion.so/my-integrations
2. 创建新的集成
3. 复制令牌（以开头 ntn_)
4. 使用集成共享要访问的页面/数据库

许可证

麻省理工学院