OpenAI Codex Integration
PostQuickAI for OpenAI Codex CLI
Codex + PostQuickAI = autonomous social media from your terminal. MCP server + 6 skills + AGENTS.md — all three open standards, all working together.
Requires Codex CLI and a PostQuickAI plan. API access is included in every plan. 7-day free trial on your first plan. Card required.
1. MCP server — the CLI way (recommended)
codex mcp add postquickai -- npx -y @postquickai/mcpThe -- separator is required — everything after it is the command and its args.
Then edit ~/.codex/config.toml to add your API key env var:
[mcp_servers.postquickai]
command = "npx"
args = ["-y", "@postquickai/mcp"]
env = { POSTQUICKAI_API_KEY = "pq_live_your_key_here" }Prefer a project-scoped config? Put it in .codex/config.toml in your repo root (trusted projects only).
2. Skills bundle (optional, recommended)
Add opinionated workflows for common social media tasks:
# Plugin install (recommended)
codex plugin install postquickai/agent-skills
# Or manual
git clone https://github.com/kodenark/postquickai-agent-skills
cp -r postquickai-agent-skills/skills ~/.codex/skills/Catalog of skills: postquick.ai/agent-skills.
3. AGENTS.md in your project
Codex treats AGENTS.md as its primary project-level config. Paste our snippet from /agents-md and any Codex session in that project understands when and how to use the PostQuickAI MCP tools.
4. Try it
In a Codex session:
API and agent access
Included in every plan
Every plan includes the REST API, MCP server, Claude Skills, and AGENTS.md integration, at no extra charge.
FAQ
Frequently Asked Questions
Easiest: `codex mcp add postquickai -- npx -y @postquickai/mcp` then edit ~/.codex/config.toml to add the POSTQUICKAI_API_KEY env var. Or add the whole [mcp_servers.postquickai] block to config.toml directly.
Global: ~/.codex/config.toml. Project-scoped (trusted projects only): .codex/config.toml in your repo root. MCP servers are defined in [mcp_servers.<name>] tables.
Yes. Codex loads SKILL.md files from ~/.codex/skills/ (user-level) and .agents/skills/ (project-level). Run `codex plugin install postquickai/agent-skills` or clone github.com/kodenark/postquickai-agent-skills and copy the skills/ folder.
Yes — Codex treats AGENTS.md as its primary project-config file. Paste our snippet from /agents-md and Codex automatically understands how to use PostQuickAI in that project.
MCP tools are the low-level primitives (createPost, publishPost, getAnalytics). Skills are opinionated workflows that chain those tools (weekly-content-batch, analyze-post-performance). Install MCP first — Skills depend on it.
Yes. Use `codex exec "..."` with the MCP config loaded. Set POSTQUICKAI_API_KEY in the CI environment. Useful for nightly analytics digests, failed-post retry automations, etc.
Troubleshooting
Connection failed
Set command to npx and provide args as an array. Restart the agent after changing its configuration.
Plan required
MCP and REST API access need an active plan. Every plan includes them. View plans.
API key missing
Create a key in API settings. Keys begin with pq_live_ and belong in the MCP configuration environment block.
Rate limit reached
Basic allows 30 requests/minute and 5,000/day. Pro allows 120 requests/minute and 50,000/day. Read the rate-limit reference.
Codex setup still failing
Check the developer documentation or email konark@arktechllc.net.
Setup guides for other agents
Each guide uses the same PostQuickAI API and MCP server with tool-specific configuration.
Ship faster with Codex + PostQuickAI
One CLI command and you're set. Use Codex for code, use it for social too.
Start free trial