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

You can find all official OpenAI plugin examples in the openai/plugins GitHub repository, specifically cataloged in the .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 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:

{
  "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 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

The repository also includes supplementary files in each plugin folder:

• Optional documentation – SKILL.md files provide human-readable descriptions of the plugin's capabilities
• Agent configurations – 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 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:

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:

#!/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 manifest and optional SKILL.md documentation.

Summary

• The .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 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 and 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 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 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. Optional 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 file to filter plugins by these categories when building your own plugin discovery interfaces.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}