Overview
mcpconfig looks for MCP config files under your home directory (~). Each app uses a specific path and format (JSON, TOML, or YAML).
- list-clients — Lists all known config locations (found and optionally not found with
--all). - list-servers — Reads JSON configs (
mcpServers) and Codexconfig.toml(mcp_servers) and prints a combined table. Other TOML/YAML configs are not parsed for servers. - add-server — Writes only to configs that exist and are JSON or Codex TOML. YAML configs (Goose, Continue.dev) are listed by list-clients but cannot be updated by add-server.
- delete-server — Removes a server by name from selected configs; only JSON and Codex TOML configs that contain that server are shown.
Config paths
Paths are relative to your home directory (~).
| App | Config path | Format | list-servers | add-server | delete-server |
|---|---|---|---|---|---|
| Claude Desktop | Library/Application Support/Claude/claude_desktop_config.json | JSON | ✓ | ✓ | ✓ |
| OpenAI Codex | .codex/config.toml | TOML | ✓ | ✓ | ✓ |
| Cursor | .cursor/mcp.json | JSON | ✓ | ✓ | ✓ |
| Cline | .cline/data/settings/cline_mcp_settings.json | JSON | ✓ | ✓ | ✓ |
| Roo Code | Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json | JSON | ✓ | ✓ | ✓ |
| Windsurf | .codeium/windsurf/mcp_config.json | JSON | ✓ | ✓ | ✓ |
| Zed | .config/zed/settings.json | JSON | ✓ | ✓ | ✓ |
| Cody | .config/cody/mcp_servers.json | JSON | ✓ | ✓ | ✓ |
| Goose | .config/goose/config.yaml | YAML | — | — | — |
| Continue.dev | .continue/config.yaml | YAML | — | — | — |
| Junie CLI | .junie/mcp/mcp.json | JSON | ✓ | ✓ | ✓ |
macOS: The
Library/Application Support/... paths are typical on macOS. On Linux or Windows, some apps may use different locations; mcpconfig uses these paths as-is from the home directory.Config format details
- JSON — Uses an
mcpServersobject. Each key is a server name; value hascommandand optionalargs. - Codex TOML — Uses
[mcp_servers.<name>]sections withcommandand optionalargs. See the Codex config reference. - YAML (Goose, Continue.dev) — Listed by list-clients only; not parsed for list-servers and not writable by add-server or delete-server.