Codex is OpenAI’s coding agent. When connected to the Shortcut MCP Server, Codex can read your Stories, Epics, and Iterations while it plans, writes, and reviews code, and keep Shortcut updated as it works.
How to Setup
See the Codex CLI help article for more options, including how to limit the OAuth scopes Codex requests.
- Install and sign in to Codex.
- Add the Shortcut server to
~/.codex/config.toml:
[mcp_servers.shortcut]
url = "https://mcp.shortcut.com/mcp"
- Run
codex mcp login shortcutand follow the browser prompt to authorize Shortcut. - Run
codex mcp listto confirm that theshortcutserver is configured.
Authentication is handled with OAuth. You do not need to create or store a Shortcut API token.
