Skip to content

MCP Reference

Codex

Connect the Parcel MCP server to OpenAI Codex CLI via the mcp-remote adapter.

Codex CLI uses the mcp-remote adapter to bridge its stdio MCP interface to Parcel’s remote OAuth server. Add the entry to your Codex config and authenticate on the first run.

Setup

  1. Add the Parcel server

    Open (or create) ~/.codex/config.toml and add:

    ~/.codex/config.toml
    [mcp_servers.parcel]
    command = "npx"
    args = ["-y", "mcp-remote", "https://mcp.parcelengineering.com/mcp"]
  2. Authenticate

    Start a Codex session. The first tool call opens the Parcel OAuth login in your browser: sign in with Microsoft or Google, or enter your work email and the 6-digit code, then pick a workspace.

Verify it works

In a Codex session, ask the assistant to run search_projects. If it returns project data, the connection is working. See Available Tools for the full list of tools and their arguments.