PushNotifi for OpenAI Codex

Plugin id pushnotifi · Codex manifest .codex-plugin/plugin.json · marketplace pushnotifi-me · version 0.4.0

What it does

Same stdio MCP server and skills as the Claude plugin: pushnotifi_request_ack / pushnotifi_await_ack, plus send, list, and test tools. Codex uses .codex-plugin/ instead of .claude-plugin/, and bundles MCP via .mcp.json at the plugin root.

Official OpenAI docs

Build plugins — manifest, .mcp.json, hooks, marketplace metadata
Plugins overview — install, @ skills, permissions

Repository layout

.codex-plugin/plugin.json — plugin identity and interface (Codex install UI)
.mcp.json — node ./mcp/dist/server.js with relative paths (avoids ${CLAUDE_PLUGIN_ROOT} interpolation issues in Codex)
hooks/hooks.json + hooks/install-mcp-deps.sh — SessionStart installs MCP production deps under mcp/node_modules when missing
.agents/plugins/marketplace.json — local marketplace; source.path ./ when this repo root is the plugin
skills/ — pushnotifi-ack-workflow, pushnotifi-scaffold, pushnotifi-recipes

Credentials

Unlike the Claude plugin's userConfig prompts, Codex expects you to provide PUSHNOTIFI_* in the environment used when Codex spawns MCP (see plugin README). Required: PUSHNOTIFI_USER_KEY. Optional: PUSHNOTIFI_GROUP_KEY, PUSHNOTIFI_APPLICATION_KEY, PUSHNOTIFI_API_BASE_URL, PUSHNOTIFI_RATE_LIMIT_PER_MINUTE.

Keys: dashboard.

Marketplace & CLI

Bundled catalog: .agents/plugins/marketplace.json. Add or refresh the marketplace with Codex CLI:

codex plugin marketplace add /path/to/openai-plugin-pushnotifi

Codex can also read a Claude-style .claude-plugin/marketplace.json in a repo; this plugin ships the Codex-native .agents/plugins/ layout.

Build MCP after source edits

cd mcp && npm install && npm run build

Source repository

github.com/thetawavetechnologies/openai-plugin-pushnotifi (monorepo: openai-plugin-pushnotifi/ under PushNotifi).