Skip to content
All agent resources

Prefect with Codex

Add the Prefect plugin to Codex for workspace diagnostics and Prefect documentation alongside your project files.

Before you start

A Codex version with plugin support and a Prefect Cloud account. The commands below run in your terminal.

Setup

  1. Add the marketplace

    Register Prefect’s official plugin repository.

    Terminal
    codex plugin marketplace add prefecthq/prefect-mcp-server
  2. Install the plugin

    Install Prefect and complete the Cloud sign-in when prompted.

    Terminal
    codex plugin add prefect@prefect

Ask Codex to help with setup

Paste this into your coding agent to walk through the setup.

Set up the official Prefect plugin for Codex using https://github.com/PrefectHQ/prefect-mcp-server. Check my installed Codex version and existing plugins first. Explain the changes and ask before installing. Guide me through Prefect Cloud OAuth; do not ask for credentials in chat. Then list accessible workspaces and ask which one to use. Do not create, run, or modify workflows. If plugin commands are unavailable, explain the supported MCP alternative from the same documentation.

If the connection fails

If your Codex version does not recognize the plugin commands, check its update instructions or use the local MCP alternative in Prefect’s README. A local MCP server and the hosted plugin can target different workspaces; confirm the target before using either.

Documentation & source

Codex plugin instructionsPrefect MCP documentation