← Mac guides

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.

Last verified 2026-11-19 · Cross-checked against AI Stopper’s offline macOS registry

macOS MCP & agent configuration paths

ClientGlobal / User Path (macOS)Project PathCLI 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.