Desktop app does not expose local stdio MCP server until cwd is set explicitly

Resolved 💬 6 comments Opened Mar 12, 2026 by bjoernzosel Closed Jun 23, 2026
💡 Likely answer: A maintainer (github-actions[bot], contributor) responded on this thread — see the highlighted reply below.

What version of the Codex App are you using (From “About Codex” dialog)?

26.309.31024 (962)

What subscription do you have?

Pro

What platform is your computer?

Darwin 25.3.0 arm64 arm

What issue are you seeing?

A local stdio MCP server for Laravel Boost was not exposed inside the Codex app, even though the server itself was valid and startable.

The same setup worked after I added a project-local .codex/config.toml with:

  • an explicit cwd
  • an absolute PHP path

So this looks like a Codex app MCP config / workspace startup context issue rather than a Laravel Boost server failure.

What steps can reproduce the bug?

  1. Use a Laravel project with laravel/boost installed.
  2. Configure Boost MCP in Codex with:
  • command = php
  • args = ["artisan", "boost:mcp"]
  1. Open the project in the Codex app.
  2. Observe that Boost tools are not exposed.
  3. Add a project-local .codex/config.toml like this:
[mcp_servers.laravel-boost]
command = "/absolute/path/to/php"
args = ["artisan", "boost:mcp"]
cwd = "/absolute/path/to/project"
enabled = true
  1. Restart the Codex app / reopen the project.
  2. Observe that the Boost MCP tools are now exposed correctly.

What is the expected behavior?

If a valid local MCP server is configured for the project, Codex should expose it as a tool without requiring a manual workaround for cwd.

Actual behavior

Laravel Boost MCP was not available in the Codex app until I added a project-local .codex/config.toml with explicit cwd and an absolute PHP path.

Additional information

In my case, the missing cwd seemed to be the key part.

The server itself was not broken:

  • php artisan boost:mcp starts cleanly
  • the workaround makes the same MCP server work in the Codex app

This suggests the problem is likely in MCP config discovery, config precedence, or workspace launch context in the app.

View original on GitHub ↗

6 Comments

github-actions[bot] contributor · 4 months ago

Potential duplicates detected. Please review them and close your issue if it is a duplicate.

  • #13025
  • #13690
  • #14189

Powered by Codex Action

bjoernzosel · 4 months ago

Possibly related issues

  • #14189 — similar Desktop/MCP symptom, but that issue looks more like a visibility/UI problem. In my case, the MCP server only became available after setting explicit cwd and absolute PHP path.
  • #13025 — related project-local config issue, but that one seems to be about project config being ignored entirely. In my case, the project-local config did work and fixed it.
  • #10499 — related Desktop vs CLI MCP mismatch, but broader than this specific cwd/startup-context case.
  • #13690 — similar MCP/Desktop problem family, but appears specific to Windows + WSL.
andkirby · 3 months ago

The bug is still present. Please fix it.

In Codex desktop, MCP returns:

Current working directory: /

codex cli does not have such issue.

Version 26.324.21641 (1228) - latest for today

lmachineone · 3 months ago

Facing same issue too!!

Where codex cli doesn't have such issue

jpcaparas · 3 months ago

Facing same issue on Codex app:

<img width="798" height="284" alt="Image" src="https://github.com/user-attachments/assets/28b6cb19-84a8-41dc-bdeb-09697d01da1f" />

Codex CLI has no issues:

<img width="1193" height="231" alt="Image" src="https://github.com/user-attachments/assets/8472e043-7351-4446-b5cc-26c67581be68" />

MCP entry on config.toml:

[mcp_servers.laravel-boost]
startup_timeout_sec = 30
command = "./vendor/bin/sail"
args = ["artisan", "boost:mcp"]
cwd = "apps/api"
mefistofelix · 3 months ago

same here, please support mcp.json and relative paths, don't go wrong like claude with claude.md specifics
also remember to support "uniform" paths, so we can specify / separated paths also on windows
and also please add some kind of log file to debug mcp server errors, it's a pain to debug