# Where Is the Claude Desktop Config File on a Mac?

https://postageformac.com/guides/claude-desktop-config-file-location-mac (checked 2026-11-19)

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

1. Open Claude Desktop and choose **Claude > Settings** in the menu bar.
2. Click **Developer** in the sidebar, then **Edit Config**. Claude Desktop creates the file if it doesn't exist yet and shows it in Finder.
3. Open `claude_desktop_config.json` in TextEdit or any code editor.
4. 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.

Go to Folder:

```
~/Library/Application Support/Claude
```

Or open the file straight from Terminal:

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:

claude_desktop_config.json:

```
{
  "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](https://postageformac.com/guides/connect-claude-to-your-email-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.json` in 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 own `mcp-server-<name>.log` there, 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.

Postage is $39 once, for macOS 14 Sonoma or later: https://postageformac.com/pricing
