harnesses

Connect Postward to Codex

Configure Codex desktop, CLI, or IDE once and verify the OAuth-backed connection.

10 minutes

Beginner

Codex users

Both execution

What You Will Finish With

Codex can operate the Postward workflow and optionally call local media-editing tools.

1
Register Postward
Codex shares MCP configuration across its surfaces.
```
codex mcp add postward --url https://postward.cc/mcp
```
2
Authenticate
Start OAuth, sign in to Postward, and authorize the intended workspace.
```
codex mcp login postward
```
3
Verify
Ask the agent: Check my Postward activation status and tell me the next incomplete step. A successful get_activation_status call proves transport, OAuth, and workspace access.
```
codex mcp list
```
4
Add local Creative
Register the Docker command as a local stdio server when you want offline trim, crop, captions, watermarking, or format conversion.
```
docker run -i --rm -v postward-creative-output:/tmp/postward-creative ghcr.io/postward-cc/creative-mcp:latest
```
5
Keep secrets out of prompts
Postward uses OAuth. Provider and storage credentials belong in the browser setup surfaces, not in the Codex conversation.

Where to go next

Ask my agent

Copy a ready prompt for this tutorial and paste it into any agent connected to Postward.

Preview the prompt

Follow the Postward tutorial "Connect Postward to Codex".

Outcome: Codex can operate the Postward workflow and optionally call local media-editing tools.
Prerequisites to verify first: A Postward account; Codex desktop, CLI, or IDE extension; Docker only for local Creative.

Steps:
1. Register Postward: Codex shares MCP configuration across its surfaces.
2. Authenticate: Start OAuth, sign in to Postward, and authorize the intended workspace.
3. Verify: Ask the agent: Check my Postward activation status and tell me the next incomplete step. A successful get_activation_status call proves transport, OAuth, and workspace access.
4. Add local Creative: Register the Docker command as a local stdio server when you want offline trim, crop, captions, watermarking, or format conversion.
5. Keep secrets out of prompts: Postward uses OAuth. Provider and storage credentials belong in the browser setup surfaces, not in the Codex conversation.

First inspect my environment and existing configuration, and verify each prerequisite before acting.
Follow the current Postward documentation rather than assuming tool names.
Do not replace unrelated configuration.
Verify the result and report exactly what changed.

Prerequisites

A Postward account
Codex desktop, CLI, or IDE extension
Docker only for local Creative

Works With

Codex desktop
Codex CLI
Codex IDE