Where Is the Claude Desktop Config File on a Mac?
Checked November 19, 2026
On a Mac, Claude Desktop's config file is ~/Library/Application Support/Claude/claude_desktop_config.json. The quickest way to open it: in Claude Desktop, choose Claude > Settings, then Developer > Edit Config. MCP servers go inside mcpServers. Quit and reopen Claude Desktop after you save, or it won't see the change.
Open it from Claude Desktop
- Open Claude Desktop and choose Claude > Settings in the menu bar.
- Click Developer in the sidebar, then Edit Config. Claude Desktop creates the file if it doesn't exist yet and shows it in Finder.
- Open
claude_desktop_config.jsonin TextEdit or any code editor. - Save, then quit Claude Desktop with Command-Q and open it again.
Open it from Finder or Terminal
The Library folder in your home folder is hidden by default. In Finder, choose Go > Go to Folder (Shift-Command-G), paste the folder path below and press Return.
~/Library/Application Support/ClaudeOr open the file straight from Terminal:
open -e "$HOME/Library/Application Support/Claude/claude_desktop_config.json"What goes in the file
The file is JSON. Each MCP server is one entry inside mcpServers, named by its key. This is the entry for Postage's mail server, the manual route that runs through npx and needs Node.js:
{
"mcpServers": {
"postage": {
"args": ["-y", "mcp-remote", "http://127.0.0.1:47913/mcp", "--header", "Authorization:${POSTAGE_AUTH}"],
"command": "npx",
"env": { "POSTAGE_AUTH": "Bearer YOUR_POSTAGE_TOKEN" }
}
}
}To add a second server, put a comma after the closing brace of the first entry and add the next one beside it, still inside mcpServers. A missing comma or an extra one makes the whole file unreadable, and then none of the servers load.
Many servers no longer need the file at all. Postage's Install in Claude Desktop button hands Claude Desktop an extension instead, which you manage under Settings > Desktop app > Extensions. Steps: How to connect Claude to your email on a Mac.
Claude Code uses different files
Claude Code doesn't read claude_desktop_config.json. It keeps its own settings:
~/.claude.json: MCP servers added with--scope user(available in every project) or the default local scope, plus other per-user state..mcp.jsonin a project's root folder: MCP servers shared with everyone who works on that project.~/.claude/settings.json: permissions, hooks and other settings for every project.
Add servers with claude mcp add rather than editing those files by hand, then type /mcp inside Claude Code to see what's connected.
When a server doesn't show up
- Quit Claude Desktop completely with Command-Q. Closing the window leaves it running with the old config.
- Check the JSON: every key in double quotes, commas between entries, none after the last one.
- Read the logs in
~/Library/Logs/Claude/. Each server writes its ownmcp-server-<name>.logthere, with the error that stopped it. - For servers started with
npx, make sure Node.js is installed. Postage's extension route avoids that requirement.
Questions
Why can't I find claude_desktop_config.json?
Claude Desktop only creates the file when something needs it. Choose Claude > Settings > Developer > Edit Config and it makes an empty one in ~/Library/Application Support/Claude/. The Library folder is hidden in Finder, so use Go > Go to Folder to reach it.
Do I need to restart Claude Desktop after editing the config?
Yes. Claude Desktop reads the file when it starts. Quit it with Command-Q, not just the window's close button, and open it again. New servers then appear in the tools menu of a new chat.
Is the Claude Desktop config the same file Claude Code uses?
No. Claude Code keeps MCP servers in ~/.claude.json and in a project's .mcp.json, and its settings in ~/.claude/settings.json. A server added to one app doesn't appear in the other until you add it there too.
Get Postage
A fast, native Mac email client with the MCP server built in. $39 once, no subscription.
One-time purchase, no subscription. Notarized by Apple. macOS 14 Sonoma or later.