Help Center

Codex CLI

Overview

Connect Codex CLI to Shortcut through the hosted Shortcut MCP Server. Codex CLI can then use Shortcut context while planning, writing, and reviewing code from your terminal.

Installation

  1. Open or create ~/.codex/config.toml. For a project-only connection, use .codex/config.toml in your workspace.
  2. Add the Shortcut server:
[mcp_servers.shortcut]
url = "https://mcp.shortcut.com/mcp"
  1. Save the file.
  2. Start authentication for the Shortcut server:
codex mcp login shortcut
  1. Follow the browser prompt to authorize Shortcut.

Authentication is handled with OAuth. You do not need to create or store a Shortcut API token.

Optional OAuth scopes

Most MCP clients select the appropriate OAuth scopes automatically. To manually limit the Shortcut permissions Codex requests, add scopes to the Shortcut server configuration:

[mcp_servers.shortcut]
url = "https://mcp.shortcut.com/mcp"
scopes = ["read", "write"]

For available scopes, see MCP Server.

Troubleshooting

Codex CLI provides MCP commands for managing servers and authentication:

  • codex mcp list shows configured MCP servers.
  • codex mcp --help shows available MCP commands.
  • codex mcp login shortcut starts authentication again for the Shortcut server.

For available entities and general troubleshooting, see MCP Server.