Skip to main content
Glama
codex-local-mcp

codex-local-mcp

by ossmalaysia

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
CODEX_BINNoAbsolute path to the Codex CLI.codex
CODEX_MODELNoModel override.
CODEX_MCP_ROOTNoRoot for all workspaces. Nothing is written outside it.~/.codex-mcp/workspaces
CODEX_TIMEOUT_SECNoDefault timeout before a run is killed.300
CODEX_NETWORK_ACCESSNoSet false to deny Codex the network.true
CODEX_MAX_TIMEOUT_SECNoCeiling a caller may request.1800
CODEX_MAX_OUTPUT_CHARSNoOutput cap; the head and tail are kept.40000
CODEX_MAX_REPORTED_FILESNoCap on reported changed files.200
CODEX_MAX_INLINE_IMAGE_BYTESNoAbove this, a downscaled preview is inlined instead.1048576

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}
resources
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
codex_runA

Hand a natural-language task to the local Codex CLI coding agent. Codex can write and run code, install packages and call APIs inside an isolated workspace folder, then this returns its output plus any files it created. If Codex takes longer than wait_sec, this returns status: running and a job_id instead; call codex_job_result with it to collect the result.

codex_generate_imageA

Generate images with the local Codex CLI. The prompt is passed through as written. Returns the saved file paths and shows the images inline, downscaling a preview when a file is too large to inline. Defaults to a fast low-quality 1024x1024 draft; raise quality for final assets. Image generation often takes longer than wait_sec, in which case this returns status: running and a job_id; call codex_job_result with it to collect the images.

codex_job_resultA

Get the result of a codex_run or codex_generate_image call that returned status: running. Waits up to wait_sec for the job to finish; if it is still running, call again. Results stay available for 60 minutes after the job finishes.

codex_read_artifactA

Read one file from a Codex workspace, for artifacts that were too large to inline. Images come back as image content, everything else as text.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4.2/5.0

Scored across 4 tools

Disambiguation4/5

Each tool has a distinct role: reading artifacts, running Codex tasks, generating images, and polling job results. codex_run and codex_generate_image overlap somewhat since image generation could be requested through run, but the dedicated tool and async behavior make the boundary clear enough.

Naming Consistency4/5

All tools share a consistent codex_ snake_case prefix. The verb/noun pattern is mostly predictable, though codex_job_result is noun-based rather than verb-based like the others.

Tool Count5/5

Four tools is well matched to a local Codex CLI wrapper: submit work, generate images, poll async jobs, and read large artifacts. Each tool earns its place without bloat.

Completeness4/5

The core lifecycle is covered: run tasks, generate images, poll async results, and retrieve artifacts. Minor gaps include no explicit job cancellation or job listing, but agents can work around these by polling or ignoring stale jobs.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues