Where is mcp.json on Mac? Every AI client path
Every major macOS AI coding agent, desktop assistant, and local model runner stores MCP and agent config files in a different place. Bookmark this verified path table or run the one-line read-only check below.
macOS MCP & agent configuration paths
| Client | Global / User Path (macOS) | Project Path | CLI Check |
|---|---|---|---|
| Claude Code | ~/.claude.json~/.claude/settings.json |
.mcp.json.claude/settings.local.json |
claude mcp list |
| Claude Desktop | ~/Library/Application Support/Claude/claude_desktop_config.json |
— | App Settings |
| Cursor | ~/.cursor/mcp.json |
.cursor/mcp.json |
Settings → MCP |
| ChatGPT / Codex | ~/.codex/config.toml~/.codex/auth.json |
.codex/config.toml |
codex mcp list |
| Windsurf | ~/.codeium/windsurf/mcp_config.json |
— | Cascade MCP panel |
| LM Studio | ~/.lmstudio/mcp.json |
— | Program tab |
| OpenCode | ~/.config/opencode/opencode.json~/.config/opencode/opencode.jsonc |
opencode.json.opencode/opencode.json |
Config file |
| Gemini CLI | ~/.gemini/settings.json |
— | gemini /mcp |
| Aider | ~/.aider.conf.yml |
.aider.conf.yml |
Config file |
One-line read-only check in Terminal
Run this safe command from your Mac Terminal to list which global AI and MCP config files currently exist on your machine (it does not read secrets or modify anything):
paths=(
"$HOME/.claude.json"
"$HOME/.claude/settings.json"
"$HOME/Library/Application Support/Claude/claude_desktop_config.json"
"$HOME/.cursor/mcp.json"
"$HOME/.codex/config.toml"
"$HOME/.codex/auth.json"
"$HOME/.codeium/windsurf/mcp_config.json"
"$HOME/.lmstudio/mcp.json"
"$HOME/.config/opencode/opencode.json"
"$HOME/.gemini/settings.json"
"$HOME/.aider.conf.yml"
)
for p in "${paths[@]}"; do [ -e "$p" ] && echo "FOUND: $p"; done
Inside a repository, check project-scoped overrides too:
ls -la .mcp.json .cursor/mcp.json .claude/settings.local.json .codex/config.toml opencode.json .opencode/opencode.json 2>/dev/null
Temporarily disable MCP configs without hand-editing JSON
Commenting out JSON blocks or renaming hidden files across five tools before a client call or security audit is tedious and easy to break. AI Stopper automatically detects these exact config files on your Mac, shows you how many MCP entries exist, snapshots them locally under ~/.aistopper/ while paused, and restores every byte on Resume Tools.
See our step-by-step MCP settings walkthrough or explore all 33 supported tools.