Commands overview

​

Usage

mcpconfig <command> [options]

​

Commands

​

Options

​

Examples

# See which MCP configs exist and where they are
mcpconfig list-clients

# See all known config locations (including missing ones)
mcpconfig list-clients --all

# See all MCP servers from every found JSON and Codex TOML config in one table
mcpconfig list-servers

# Interactively add an MCP server to one or more configs
mcpconfig add-server

# Interactively remove an MCP server by name from selected configs
mcpconfig delete-server

​

Output

• list-clients — One line per config: app name, ✓ or ✗ (found or not), and the full path when found.
• list-servers — A table with columns: APP, SERVER, COMMAND, ARGS. JSON configs use mcpServers; Codex uses ~/.codex/config.toml and [mcp_servers.<name>]. Other TOML/YAML configs are skipped.
• add-server — Writes the new server to each selected config; shows success or an error.
• delete-server — Removes the server from each selected config; shows success, “Server not found”, or an error.

​

See also