2 2
3## Overview3## Overview
4 4
5Plugins bundle skills, app integrations, and MCP servers into reusable5Plugins bundle capabilities into reusable workflows in ChatGPT. They
6workflows for Codex.6can include skills, an MCP-backed app, or both. Plugins are
7available in ChatGPT Work on the web and in Work or Codex in the ChatGPT
8desktop app. Codex CLI and the IDE extension can also browse and install
9plugins for a Codex environment.
7 10
8Extend what Codex can do, for example:11
12
13In the ChatGPT desktop app, open **Plugins** from Work or Codex to browse,
14install, and use plugins. Installed plugins can add skills, connectors, and MCP
15tools to new chats.
16
17
18
19
20
21
22
23
24
25Extend what ChatGPT can do, for example:
9 26
10- Install the Codex Security plugin to scan authorized code and confirm27- Install the Codex Security plugin to scan authorized code and confirm
11 plausible vulnerability findings.28 plausible vulnerability findings.
12- Install the Gmail plugin to let Codex read and manage Gmail.29- Install the Gmail plugin to let ChatGPT read and manage Gmail.
13- Install the Google Drive plugin to work across Drive, Docs, Sheets, and30- Install the Google Drive plugin to work across Drive, Docs, Sheets, and
14 Slides.31 Slides.
15- Install the Slack plugin to summarize channels or draft replies.32- Install the Slack plugin to summarize channels or draft replies.
16- Install [Sites](https://developers.openai.com/codex/sites) to create and deploy hosted websites,
17 web apps, and games.
18 33
19A plugin can contain:34A plugin can contain one or more of these parts:
20 35
21- **Skills:** reusable instructions for specific kinds of work. Codex can load36- **Skills:** reusable instructions for specific kinds of work. ChatGPT can load
22 them when needed so it follows the right steps and uses the right references37 them when needed so it follows the right steps and uses the right references
23 or helper scripts for a task.38 or helper scripts for a task.
24- **Apps:** connections to tools like GitHub, Slack, or Google Drive, so39- **Apps:** connections to tools like GitHub, Slack, or Google
25 Codex can read information from those tools and take actions in them.40 Drive, so ChatGPT can read information from those tools and take actions in
26- **MCP servers:** services that give Codex access to more tools or shared41 them. Apps expose tools and can optionally include custom ChatGPT UI.
27 information, often from systems outside your local project.42- **MCP servers:** services that give ChatGPT access to more tools or shared
43 information, often from systems outside your local project. They're also the services behind apps. They define tools, enforce auth, return structured data, and perform actions against external systems.
44- **Browser extensions:** browser capabilities that a plugin needs for its
45 workflow.
46- **Hooks:** commands that run at configured lifecycle points. Review and trust
47 plugin hooks before you enable them.
48- **Scheduled task templates:** reusable starting points for recurring tasks
49 where scheduled tasks are available.
28 50
29You can share plugins by publishing them through a marketplace source, such as a51You can share plugins by publishing them through a marketplace source, such as a
30repo marketplace for a project or team. See [Build plugins](https://developers.openai.com/codex/plugins/build)52repo marketplace for a project or team. See [Build plugins](https://learn.chatgpt.com/docs/build-plugins)
31for marketplace setup, packaging, and distribution guidance.53for marketplace setup, packaging, and distribution guidance.
32 54
55If you are building an integration, start with [Build an app](https://learn.chatgpt.com/docs/build-app).
56If the app needs custom ChatGPT UI, use the [Apps SDK](https://developers.openai.com/apps-sdk) for that
57optional UI layer.
58
33## Use and install plugins59## Use and install plugins
34 60
35### Plugin Directory in the Codex app61<a id="plugin-directory-in-the-codex-app"></a>
62
63
64
65### Plugins in ChatGPT
66
67To browse and install curated plugins:
68
69- On the web, select Work and open **Plugins**.
70- In the ChatGPT desktop app, select Work or Codex and open **Plugins**.
71
72
73
36 74
37Open **Plugins** in the Codex app to browse and install curated plugins.
38 75
39<CodexScreenshot76<CodexScreenshot
40 alt="Codex Plugins page"77 alt="Plugins page in the ChatGPT desktop app"
41 lightSrc="/images/codex/plugins/directory.webp"78 lightSrc="/images/codex/plugins/directory.webp"
42 darkSrc="/images/codex/plugins/directory-dark.webp"79 darkSrc="/images/codex/plugins/directory-dark.webp"
43/>80/>
44 81
45The plugin directory groups plugins into categories:
46 82
47- **Curated by OpenAI:** highlighted plugins available to all Codex users.
48- **Shared with you:** plugins shared by other members of your ChatGPT
49 workspace.
50- **Created by you:** plugins you created or added to your own workspace.
51 83
52### Plugin directory in the CLI
53 84
54In Codex CLI, run the following command to open the plugins list:
55 85
56```text86The plugin directory organizes plugins into tabs:
57codex
58/plugins
59```
60 87
61<CodexScreenshot88- **OpenAI:** plugins built by OpenAI.
62 alt="Plugins list in Codex CLI"89- **Your workspace name:** plugins provided by your workspace.
63 lightSrc="/images/codex/plugins/cli_light.png"90- **Personal:** personal marketplace plugins, including **Created by me** and
64 darkSrc="/images/codex/plugins/codex-plugin-cli.png"91 **Shared with me** sections when those plugins are available.
65/>
66 92
67The CLI plugin browser groups plugins by marketplace. Use the marketplace tabs93Use the separate **Installed** row to review plugins you already installed.
68to switch sources, open a plugin to inspect details, install or uninstall
69marketplace entries, and press <kbd>Space</kbd> on an installed plugin to toggle
70its enabled state.
71 94
72### Install and use a plugin95### Install and use a plugin in ChatGPT
73 96
74Once you open the plugin directory:97Once you open the plugin directory:
75 98
76<WorkflowSteps>99<WorkflowSteps>
77 100
781. Search or browse for a plugin, then open its details.1011. Search or browse for a plugin, then open its details.
792. Select the install button. In the app, select the plus button or1022. Select the plus button to install the plugin.
80 **Add to Codex**. In the CLI, select `Install plugin`.1033. If the plugin needs a connector, connect it when prompted. Some plugins
813. If the plugin needs an external app, connect it when prompted. Some plugins
82 ask you to authenticate during install. Others wait until the first time you104 ask you to authenticate during install. Others wait until the first time you
83 use them.105 use them.
844. After installation, start a new thread and ask Codex to use the plugin.1064. After installation, start a new task and ask ChatGPT to use the plugin.
85 107
86</WorkflowSteps>108</WorkflowSteps>
87 109
88After you install a plugin, you can use it directly in the prompt window:110After you install a plugin, you can use it directly in the prompt window:
89 111
112
113
114
115
90<CodexScreenshot116<CodexScreenshot
91 alt="Codex Plugins page"117 alt="Installed plugin on the Plugins page"
92 lightSrc="/images/codex/plugins/plugin-github-invoke.png"118 lightSrc="/images/codex/plugins/plugin-github-invoke.png"
93 darkSrc="/images/codex/plugins/plugin-github-invoke-dark.png"119 darkSrc="/images/codex/plugins/plugin-github-invoke-dark.png"
94/>120/>
101 from today" or "Pull the latest launch notes from Google Drive."131 from today" or "Pull the latest launch notes from Google Drive."
102 </p>132 </p>
103 <p class="mt-3 text-sm text-secondary">133 <p class="mt-3 text-sm text-secondary">
104 Use this when you want Codex to choose the right installed tools for the134 Use this when you want ChatGPT to choose the right installed tools for the
105 task.135 task.
106 </p>136 </p>
107 </div>137 </div>
113 explicitly.143 explicitly.
114 </p>144 </p>
115 <p class="mt-3 text-sm text-secondary">145 <p class="mt-3 text-sm text-secondary">
116 Use this when you want to be specific about which plugin or skill Codex146 Use this when you want to be specific about which plugin or skill ChatGPT
117 should use. See <a href="/codex/app/commands">Codex app commands</a> and 147 should use. See <a href="/codex/skills-and-plugins">Skills & Plugins</a>.
118 <a href="/codex/skills">Skills</a>.
119 </p>148 </p>
120 </div>149 </div>
121</div>150</div>
122 151
152
153
154
155
156
157
123### How permissions and data sharing work158### How permissions and data sharing work
124 159
125Installing a plugin makes its workflows available in Codex, but your existing
126[approval settings](https://developers.openai.com/codex/agent-approvals-security) still apply. Any
127connected external services remain subject to their own authentication,
128privacy, and data-sharing policies.
129 160
130- Bundled skills are available as soon as you install the plugin.161
131- If a plugin includes apps, Codex may prompt you to install or sign in to162
132 those apps in ChatGPT during setup or the first time you use them.163
164When a plugin capability runs through a Codex host, the host's [sandbox and
165approval policy](https://learn.chatgpt.com/docs/agent-approvals-security) applies.
166Connections to external services use that service's own authentication and
167access controls.
168
169
170
171- Bundled skills become available when you start a new chat or CLI session
172 after installation.
173- If a plugin includes connectors, ChatGPT may prompt you to install or sign in to
174 those connectors in ChatGPT during setup or the first time you use them.
133- If a plugin includes MCP servers, they may require extra setup or175- If a plugin includes MCP servers, they may require extra setup or
134 authentication before you can use them.176 authentication before you can use them.
135- When Codex sends data through a bundled app, that app's terms and privacy177- When ChatGPT sends data through a bundled connector, that service's terms and privacy
136 policy apply.178 policy apply.
137 179
138### Remove or turn off a plugin180### Remove a plugin
139 181
140To remove a plugin, reopen it from the plugin browser and select182To remove a plugin, reopen it from the plugin browser and select
141**Uninstall plugin**.183**Uninstall plugin** when that action is available. Workspace-installed or
142 184default plugins may not offer that action; your workspace administrator controls
143Uninstalling a plugin removes the plugin bundle from Codex, but bundled apps185them instead.
144stay installed until you manage them in ChatGPT.
145
146If you want to keep a plugin installed but turn it off, set its entry in
147`~/.codex/config.toml` to `enabled = false`, then restart Codex:
148 186
149```toml187Uninstalling a plugin removes the plugin bundle from that ChatGPT or Codex
150[plugins."gmail@openai-curated"]188environment, but bundled connectors stay connected until you manage them in
151enabled = false189ChatGPT.
152```
153 190
154## Build your own plugin191## Build your own plugin
155 192
156If you want to create, test, or distribute your own plugin, see193If you want to create, test, or distribute your own plugin, see
157[Build plugins](https://developers.openai.com/codex/plugins/build). That page covers local scaffolding,194[Build plugins](https://learn.chatgpt.com/docs/build-plugins). That page covers local scaffolding,
158manual marketplace setup, workspace sharing, plugin manifests, and packaging195manual marketplace setup, workspace sharing, plugin manifests, and packaging
159guidance.196guidance.
160 197
198If your plugin includes an app, see [Build an app](https://learn.chatgpt.com/docs/build-app). Apps are
199MCP-backed integrations. They can work with tools alone, or add custom ChatGPT UI
200through the [Apps SDK](https://developers.openai.com/apps-sdk) when a visual surface helps the workflow.
201
202When your plugin is ready for review, see
203[Submit plugins](https://learn.chatgpt.com/docs/submit-plugins) for the OpenAI Platform submission
204flow, required permissions, review materials, MCP checks, and test case
205requirements.
206
161## Plugin guides207## Plugin guides
162 208
163- [Record & Replay](https://developers.openai.com/codex/record-and-replay): Show Codex a workflow209- [Record & Replay](https://learn.chatgpt.com/docs/extend/record-and-replay): Show ChatGPT a workflow
164 once and turn it into a reusable skill.210 once and turn it into a reusable skill.
165- [Codex Security plugin quickstart](https://developers.openai.com/codex/security/plugin): Install the211- [Codex Security plugin](https://learn.chatgpt.com/docs/security/plugin): Scan authorized code,
166 plugin, scan authorized code, and review the result.212 confirm findings, and prepare reviewed fixes.