﻿---
title: "安装 Notion 插件"
summary: "安装 notion@openai-curated 并连接 Notion，使用插件提供的技能和 App 访问工作区内容。"
category: skills
level: starter
surfaces: [cli, app]
tags: ["plugins", "Notion", "notion@openai-curated", "MCP"]
canonical: /tips/notion-codex-plugin/
---

# 安装 Notion 插件

安装 notion@openai-curated 并连接 Notion，使用插件提供的技能和 App 访问工作区内容。

安装 notion@openai-curated 并连接 Notion，使用插件提供的技能和 App 访问工作区内容。

这是 Notion 工作区插件，用来搜页面、改文档和数据库，并把规格、会议和决策收成结构化输出。产品页是 [Notion](https://openai.com/business/plugins/notion/)。清单 [`plugin.json`](https://github.com/openai/plugins/blob/main/plugins/notion/.codex-plugin/plugin.json) 的 name 是 `notion`、version 是 `0.1.7`，所以精选 id 是 `notion@openai-curated`。能力含 Interactive、Read、Write。

CLI：

```bash
codex plugin add notion@openai-curated
codex plugin list
```

TUI `/plugins` 或桌面 Plugins 搜 Notion 再装，效果一样。装完按提示 Connect Notion 账号。IDE 扩展没有 `/plugins`，用 CLI 这条。

插件同时登记 [`.app.json`](https://github.com/openai/plugins/blob/main/plugins/notion/.app.json)、[`.mcp.json`](https://github.com/openai/plugins/blob/main/plugins/notion/.mcp.json) 和 `skills/`。MCP 表名是 `notion`，type 是 http，URL 是 `https://mcp.notion.com/mcp`（带 `/mcp`），`oauth_resource` 是 `https://mcp.notion.com`。插件已经登记 MCP 时，不要再手写 `mcp add notion --url https://mcp.notion.com/mcp` 叠一张。只要 MCP、不要技能和 App 时，才走现有的本机 MCP 技巧。

技能随插件走，仓库 [README](https://github.com/openai/plugins/blob/main/plugins/notion/README.md) 列出 `notion-spec-to-implementation`、`notion-research-documentation`、`notion-meeting-intelligence`、`notion-knowledge-capture`。不要 `npx skills add` 当 Codex 安装器，也不要手拷到 `~/.codex/skills`。

在支持的 Codex 任务视图里，打开 Sources → Use plugins，再搜已安装的 Notion。ChatGPT 里可以用 `@Notion`。

0.154 起先看**当前会话**的 `/plugins`；没有再新开。`codex plugin list` 里应看到 `notion@openai-curated`。网页 Cloud 不读 `~/.codex/config.toml`。Cloud 用 Plugins 搜 Notion。

使用注意事项：

- 操作影响：改页面、改数据库属性会动真实 Notion 工作区。


## 来源

- [OpenAI · Notion](https://openai.com/business/plugins/notion/)
- [openai/plugins · notion plugin.json](https://github.com/openai/plugins/blob/main/plugins/notion/.codex-plugin/plugin.json)
- [openai/plugins · notion README](https://github.com/openai/plugins/blob/main/plugins/notion/README.md)
