by 运行时依赖
安装命令
点击复制技能文档
notion-remote-mcp 通过 mcporter 使用 Notion，后端依托官方托管 MCP：https://mcp.notion.com/mcp
凭据配置 OAuth token 由 Maverick 在用户连接 Notion 账户后自动注入 $env:NOTION_MCP_OAUTH_TOKEN，切勿直接向用户索要 token。
工作流 调用工具前确认服务器可达：mcporter list notion --schema 先搜索再假定页面或数据库 ID：用标题关键词搜索以解析 ID。 先读后写——追加或更新前先获取当前内容。 执行破坏性操作（删除、归档、覆盖）前，与用户确认目标页面/数据库。
核心工具 search — 全文搜索页面与数据库（按标题或内容）。用户提到名称时优先使用。 retrieve_page — 按 ID 获取页面属性。已有页面 ID 时使用。 retrieve_block_children — 获取页面内容块。追加/编辑前必须调用。 append_block_children — 向页面追加新块（段落、标题、待办、代码等）。 update_page — 更新页面属性（标题、状态、日期等）。 create_page — 在父页面或数据库内新建页面。 query_database — 按条件过滤/排序数据库行，需 database_id，可附加 filter 与 sorts。 retrieve_database — 查询数据库结构（属性定义），用于 query_database 前。 create_database_item — 向数据库插入新行。 update_block — 按 ID 编辑已有块内容。 delete_block — 归档块（Notion 软删除，可恢复）。
工具选择指南 用户“查找/搜索”→ 先 search，再 retrieve_page 或 retrieve_block_children。 用户“添加/写入”→ 先 retrieve_block_children 确认现状，再 append_block_children。 用户更新属性（状态、日期、负责人）→ update_page。 用户查询表格/数据库 → 先 retrieve_database 看结构，再 query_database。 用户在数据库新建条目 → create_database_item。
操作规则 调用 retrieve_page 或 query_database 前，必须通过 search 把名称解析为 ID，禁止猜 ID。 追加块时匹配页面现有样式（如页面用提示框，则继续用提示框）。 delete_block 与页面归档视为高影响操作，执行前必须让用户确认。 搜索返回多个同名结果时，列出供用户选择。 Notion API 限流：3 次/秒；批量操作间稍作停顿。 工具返回 401 表示 token 过期，提示用户在 Maverick 设置中重新连接 Notion 账户。
常见错误 object_not_found — ID 错误或集成无权限，检查 Notion 分享设置。 validation_error — 属性名或块类型错误，写入前用 retrieve_database 确认属性名。 rate_limited — 稍等 1 秒后重试。