# Where to Find Example OpenAI Plugins: A Complete Guide to the Official Repository

> Discover official OpenAI plugin examples in the openai/plugins GitHub repository. Find source code and configurations in the marketplace.json manifest.

- Repository: [OpenAI/plugins](https://github.com/openai/plugins)
- Tags: getting-started
- Published: 2026-06-26

---

**You can find all official OpenAI plugin examples in the `openai/plugins` GitHub repository, specifically cataloged in the [`.agents/plugins/marketplace.json`](https://github.com/openai/plugins/blob/main/.agents/plugins/marketplace.json) manifest file with source code and configurations located under the `plugins/` directory.**

The `openai/plugins` repository serves as the definitive collection of example OpenAI plugins. This curated resource contains production-ready integrations for communication, productivity, and creative tools, all organized with standardized manifests that define their capabilities, categories, and authentication policies.

## The Master Plugin Catalog

The single source of truth for discovering available OpenAI plugin examples is the **default marketplace manifest** located at [`.agents/plugins/marketplace.json`](https://github.com/openai/plugins/blob/main/.agents/plugins/marketplace.json) in the repository root. This JSON file contains an array of plugin descriptors, each providing metadata required to identify and configure the plugin.

Each entry in the marketplace manifest includes:

- **name** – The unique identifier for the plugin (e.g., `slack`, `figma`, `linear`)
- **source** – Contains `source` type (typically `local`) and `path` pointing to the plugin folder under `plugins/`
- **policy** – Defines `installation` availability and `authentication` mode (commonly `ON_INSTALL`)
- **category** – Groups similar plugins together (e.g., `Communication`, `Creativity`, `Productivity`)

A typical descriptor looks like this:

```json
{
  "name": "slack",
  "source": {
    "source": "local",
    "path": "./plugins/slack"
  },
  "policy": {
    "installation": "AVAILABLE",
    "authentication": "ON_INSTALL"
  },
  "category": "Communication"
}

```

By reading this manifest, you can programmatically enumerate every example OpenAI plugin shipped with the repository, filter by `category`, or inspect the `authentication` requirements for each integration.

## Individual Plugin Structure

Each OpenAI plugin example resides in its own folder under the `plugins/` directory. Within each plugin folder, you will find a mandatory manifest at [`.codex-plugin/plugin.json`](https://github.com/openai/plugins/blob/main/.codex-plugin/plugin.json) that describes the plugin's specific capabilities, including OpenAPI specifications and skill definitions.

For example, the Slack plugin's detailed manifest lives at:

- [`plugins/slack/.codex-plugin/plugin.json`](https://github.com/openai/plugins/blob/main/plugins/slack/.codex-plugin/plugin.json)

The repository also includes supplementary files in each plugin folder:

- **Optional documentation** – [`SKILL.md`](https://github.com/openai/plugins/blob/main/SKILL.md) files provide human-readable descriptions of the plugin's capabilities
- **Agent configurations** – [`agents/openai.yaml`](https://github.com/openai/plugins/blob/main/agents/openai.yaml) files contain invocation settings used by OpenAI agents
- **Assets and resources** – Icons, documentation, and implementation code supporting the plugin's functionality

The repository's [`README.md`](https://github.com/openai/plugins/blob/main/README.md) provides a high-level overview of the directory layout and highlights notable plugins such as `figma`, `notion`, and `build-web-apps`.

## How to Programmatically Discover OpenAI Plugin Examples

You can retrieve the complete list of available plugins without manually browsing the repository by fetching the raw marketplace manifest.

### Python: List plugins and categories

This script downloads the marketplace manifest and prints each plugin's name and category:

```python
import json
import urllib.request

# URL of the marketplace manifest

MANIFEST_URL = (
    "https://raw.githubusercontent.com/openai/plugins/main/.agents/plugins/marketplace.json"
)

def fetch_manifest(url: str) -> dict:
    with urllib.request.urlopen(url) as resp:
        return json.loads(resp.read().decode())

def list_plugins(manifest: dict):
    for plugin in manifest["plugins"]:
        name = plugin["name"]
        category = plugin.get("category", "Uncategorized")
        print(f"{name:20} – {category}")

if __name__ == "__main__":
    data = fetch_manifest(MANIFEST_URL)
    list_plugins(data)

```

Running this outputs the available OpenAI plugin examples with their assigned categories:

```

linear               – Productivity
slack                – Communication
figma                – Creativity
...

```

### Bash: Show authentication modes

Using `curl` and `jq`, you can quickly inspect which authentication mode each plugin requires:

```bash
#!/usr/bin/env bash
set -euo pipefail

MANIFEST="https://raw.githubusercontent.com/openai/plugins/main/.agents/plugins/marketplace.json"

curl -s "$MANIFEST" |
  jq -r '.plugins[] | "\(.name) \t \(.policy.authentication)"' |
  column -t

```

This produces a tabular view of plugin names and their security policies:

```

linear                 ON_INSTALL
slack                  ON_INSTALL
figma                  ON_INSTALL
...

```

## Notable OpenAI Plugin Examples

The repository contains diverse examples across multiple categories. Based on the marketplace manifest structure found in the `openai/plugins` source code, here are several highlighted integrations:

- **slack** – Located in `plugins/slack/`, categorized under `Communication`, requiring `ON_INSTALL` authentication
- **figma** – A `Creativity` category plugin found in `plugins/figma/` for design tool integration
- **linear** – A `Productivity` tool located at `plugins/linear/` for project management
- **notion** – Document and workspace management plugin referenced in the repository README
- **build-web-apps** – A specialized plugin for application development mentioned in the documentation

Each follows the standard structure with a [`.codex-plugin/plugin.json`](https://github.com/openai/plugins/blob/main/.codex-plugin/plugin.json) manifest and optional [`SKILL.md`](https://github.com/openai/plugins/blob/main/SKILL.md) documentation.

## Summary

- The [`.agents/plugins/marketplace.json`](https://github.com/openai/plugins/blob/main/.agents/plugins/marketplace.json) file provides the complete catalog of available OpenAI plugin examples in the repository
- Each plugin resides in the `plugins/<name>/` directory with a mandatory [`.codex-plugin/plugin.json`](https://github.com/openai/plugins/blob/main/.codex-plugin/plugin.json) manifest
- Plugin descriptors include `category`, `policy` (installation and authentication), and `source.path` pointing to local implementation code
- You can programmatically enumerate all available plugins using the raw GitHub URL of the marketplace manifest with Python or command-line tools
- The repository includes optional resources like [`SKILL.md`](https://github.com/openai/plugins/blob/main/SKILL.md) and [`agents/openai.yaml`](https://github.com/openai/plugins/blob/main/agents/openai.yaml) for detailed configuration and documentation

## Frequently Asked Questions

### Where is the official list of OpenAI plugin examples hosted?

The official list is maintained in the `openai/plugins` repository within the [`.agents/plugins/marketplace.json`](https://github.com/openai/plugins/blob/main/.agents/plugins/marketplace.json) file. This JSON array contains every plugin descriptor shipped with the repository, including names, categories, and source paths. You can view it directly on GitHub or fetch it programmatically via the raw content URL.

### How do I examine the capabilities of a specific plugin example?

Each plugin folder contains a [`.codex-plugin/plugin.json`](https://github.com/openai/plugins/blob/main/.codex-plugin/plugin.json) manifest that defines its capabilities, OpenAPI specifications, and skill definitions. For example, the Slack plugin's capabilities are defined in [`plugins/slack/.codex-plugin/plugin.json`](https://github.com/openai/plugins/blob/main/plugins/slack/.codex-plugin/plugin.json). Optional [`SKILL.md`](https://github.com/openai/plugins/blob/main/SKILL.md) files in the same directory provide human-readable descriptions of what the plugin can do.

### What authentication modes do these OpenAI plugin examples require?

According to the marketplace manifest structure, most plugins use `ON_INSTALL` authentication, meaning credentials are required when the plugin is first installed. The `policy` field in each marketplace entry explicitly defines both the `installation` status (typically `AVAILABLE`) and the `authentication` mode, allowing you to verify requirements before implementation.

### Can I filter OpenAI plugin examples by category?

Yes. The marketplace manifest includes a `category` field for each plugin, grouping them into classifications like `Communication` (e.g., Slack), `Creativity` (e.g., Figma), and `Productivity` (e.g., Linear). You can parse the [`.agents/plugins/marketplace.json`](https://github.com/openai/plugins/blob/main/.agents/plugins/marketplace.json) file to filter plugins by these categories when building your own plugin discovery interfaces.