Install pail in Codex CLI

Get pail's MCP server connected to Codex CLI in under two minutes. The server exposes all 10 tools; plan gates still apply, including Pro access for preview.

Prerequisites

• Codex CLI installed (npm install -g @openai/codex)
• A pail account at pail.thalos.ai (free tier is fine)
• Your API key from the welcome page after sign-in

Install

Run this command in your terminal. Codex CLI stores the server in ~/.codex/mcp.json. Replace YOUR_API_KEY with the key from your pail welcome page.

codex mcp add --name pail \
  --url https://pail.thalos.ai/mcp \
  --bearer YOUR_API_KEY

Verify installation

Run codex mcp list. You should see pail listed with the correct URL.

codex mcp list

First share

With pail connected, ask your agent to share a file. This verifies that the tool is reachable and your API key is working.

# In a Codex CLI session, ask your agent:
share a file called hello.md with the content "# Hello from pail!"

The agent calls the share tool and returns a URL. Open it in your browser to see the rendered Markdown.

Next steps