Codex + Zaprep

Give OpenAI Codex your Instagram automations

One command adds Zaprep to Codex. It can then create, check and export your Instagram and Facebook automations from the CLI, the IDE extension or the Codex app.

One-command setupOAuth sign-in, API key for CICLI, IDE extension and app
CodexZaprep connected

Which of my automations have not triggered in 14 days? Pause them and tell me what you paused.

✓ list_automations✓ get_automation_activity✓ toggle_automation

Checked 11 automations across 2 accounts.

Paused 3 that had no runs in 14 days: "Old SALE", "Black Friday" and "Test rule". The other 8 are active and firing.

Example conversation. Real tool names.

Coding agent setup

How do I connect Zaprep to Codex?

Codex CLI, the Codex IDE extension or the Codex app. They share the same config file.

Server URL
https://www.zaprep.com/api/mcp
Sign-in
OAuth, or a Zaprep API key for scripts
Cost
Included on every Zaprep plan, Free included
New automations
Saved paused until you turn them on
Platforms
Instagram and Facebook Pages
Revoke
Settings, then AI tools in Zaprep

Zaprep MCP server URL

https://www.zaprep.com/api/mcp
  1. 1

    Add the server

    Run the first command below, or add the block to ~/.codex/config.toml yourself.

  2. 2

    Sign in

    Run codex mcp login zaprep. Your browser opens Zaprep so you can approve access.

  3. 3

    In the IDE or app

    Open Settings, then MCP servers, then Add server. Choose Streamable HTTP, paste the URL and sign in when asked.

  4. 4

    For CI, use a key

    Create a key under Settings, then API keys in Zaprep and point bearer_token_env_var at it, as in the second block.

Terminal and ~/.codex/config.toml
codex mcp add zaprep --url https://www.zaprep.com/api/mcp
codex mcp login zaprep

# headless / CI alternative, in ~/.codex/config.toml
[mcp_servers.zaprep]
url = "https://www.zaprep.com/api/mcp"
bearer_token_env_var = "ZAPREP_API_KEY"

Need an API key? Create one in Zaprep. Official Codex docs: Codex MCP docs.

Try these

What can you ask Codex?

Copy a prompt, paste it into Codex, and adjust the keyword or link.

Clean up

“Pause every automation that has not fired in 30 days.”

Reporting

“Write a markdown report of DMs sent per automation this month.”

Templates

“Create the same three keyword automations on my new client account, paused so I can check them.”

Comments

“Show me the latest comments on my top post that did not get a reply.”

Scheduled

“Arm a LINK automation for the next reel I post on @brand.main.”

Usage

“How many contacts have I messaged this month, and what is my plan limit?”

40+ tools

What can Codex do with Zaprep?

Everything you do in the Zaprep dashboard, except billing, is available as an MCP tool.

Create automations

Comment-to-DM, DM keyword, story reply and follow-gated flows, from a post link or a plain description. Saved paused until you turn them on.

create_automationresolve_postduplicate_automation

Read the numbers

DMs sent, link clicks, followers gained and the full funnel for every automation.

get_analyticsget_automation_metricsget_automation_funnel

Fix what broke

Find out why a rule skipped, then pause, edit or switch it back on.

troubleshoot_automationget_automation_activitytoggle_automation

Get AI suggestions

Turn captions into ready-to-approve keyword automations, one post or all of them.

suggest_automationbulk_suggest_automationsanalyze_post

Work your leads

List and export everyone who shared an email or messaged you.

list_contactsexport_contacts_csv

Run the rest

Scheduled automations, short links, link in bio, media kit and AI replies.

create_scheduled_automationcreate_linkupdate_link_in_bio

Best for: Teams already working in Codex who want automations managed next to their code.

See every tool · What it can set up on Instagram

Sign-in

OAuth or API key?

Codex supports both. OAuth is quicker on your own machine.

OAuth CodexAPI key Codex
SetupPaste the URL, sign in to ZaprepCreate a key in Settings, then API keys
Best forChat apps and editors on your own machineCLIs, CI, servers and workflow tools
Credentials storedShort-lived tokens, refreshed automaticallyOne zap_ key you keep secret
RevokeDisconnect it in Settings, then AI toolsDelete it in Settings, then API keys

Limits

What Codex cannot do in Zaprep

  • Send DMs or comment replies outside your automations. The AI sets up rules; Zaprep sends through Meta’s official APIs.
  • Turn on a new automation it created unless you, or the AI after you confirm, switch it on.
  • Touch billing, payments or your plan.
  • Connect, reconnect or remove your Instagram and Facebook accounts.
  • Read your Instagram password. Accounts are connected with Meta login, and the AI signs in to Zaprep, not Instagram.

Channels

Which platforms can Codex automate?

One connection covers every account in your Zaprep workspace.

Codex + Zaprep FAQ

No. ChatGPT is the chat app and connects Zaprep as a custom connector. Codex is OpenAI’s coding agent and reads MCP servers from config.toml. Same Zaprep server, different setup. See the ChatGPT page for the chat setup.

Use OAuth (codex mcp login zaprep) on your own machine. Use an API key for CI or anywhere a browser cannot open. Codex reads the key from the environment variable you name, so it never sits in the config file.

With OAuth, run codex mcp login zaprep again. With a key, check that ZAPREP_API_KEY is set in the shell that launched Codex (echo $ZAPREP_API_KEY), then restart Codex.

Yes. Zaprep runs its own remote MCP server at https://www.zaprep.com/api/mcp. No Zapier or other middleman is involved.

Yes. MCP access is included on every Zaprep plan, Free included. Your plan’s usual limits on automations and DMs still apply.

To run automations, yes: connect an Instagram professional account or a Facebook Page in Zaprep first. Without one the AI can only read your Zaprep settings.

Instagram professional accounts and Facebook Pages today. TikTok and YouTube are coming next.

New automations an AI creates are saved paused, so nothing sends until you or the AI turns it on after you confirm. Edits to an automation that is already on apply right away, and most AI apps ask before running a change. You can disconnect any AI app in Zaprep under Settings, then AI tools.

Yes. Once connected, the AI can list and export the contacts your automations collected, including emails. Only connect AI apps you trust, and disconnect any you stop using.

Open Settings, then AI tools in Zaprep and choose Disconnect next to the app. It is signed out right away. For an API key, delete it under Settings, then API keys.

Last updated . Menu names in other apps change often; the official docs link above has the latest.

Let Codex run your DM automations

Free plan, no card. Connect Instagram or a Facebook Page, then add Zaprep to your AI tool.