Skip to main content

​
Synopsis

mcpconfig list-clients [--all]

​
Description

list-clients finds and lists MCP config files that your AI coding apps use. By default it shows only configs that exist on your system, with their full paths. Use —all to show every known config location (including ones that don’t exist yet).

​
Options

OptionShortDescription
—all-aShow all known config locations (found and not found).

​
Examples

# Show only configs that were found on disk
mcpconfig list-clients

# Show every known config location
mcpconfig list-clients --all

​
Output

For each config you see:
  • App name — e.g. Claude Desktop, Cursor, Codex.
  • ✓ or ✗ — Whether the config file was found.
  • Path — Full path to the config file when found.
list-servers, add-server, and delete-server use only JSON and Codex TOML configs; other TOML and YAML configs are listed here but not parsed or written.

​
See also