How to add MCP servers to Claude Desktop
Claude Desktop is Anthropic's chat app for macOS, Windows and Linux. Local MCP servers are listed in claude_desktop_config.json, and Claude asks for your approval before it uses them.
Add an MCP server to Claude Desktop
- 1Open Settings, then Developer, then Edit Config to open
claude_desktop_config.json. - 2Paste the server under
mcpServersand save the file. - 3Quit Claude Desktop fully and open it again.
- 4Remote servers are added as connectors in Settings, not in this file.
Example: Codebase Memory
{
"mcpServers": {
"codebase-memory-mcp": {
"command": "npx",
"args": [
"-y",
"codebase-memory-mcp"
]
}
}
}Local servers here, remote servers as connectors
- The config file is for servers that run on your computer; remote servers are added as connectors in the app.
- Claude asks for approval before each action a server takes, such as a file operation.
- Each server writes its own log,
mcp-server-NAME.log, which is the first place to look when it fails. - Use absolute paths in
args; the app does not start servers from your project folder.
Where Claude Desktop keeps MCP servers
~/Library/Application Support/Claude/claude_desktop_config.jsonmacOS%APPDATA%\Claude\claude_desktop_config.jsonWindows~/.config/Claude/claude_desktop_config.jsonLinux
Check it loaded: Add files, connectors, and more → Connectors → Manage connectors
Limits and settings
- The config file holds local servers; remote servers are added as connectors in the app instead.
- Fully quit and reopen the app after editing the config.
- Claude asks for approval before each action a server takes.
When a server does not work in Claude Desktop
- Logs live in
~/Library/Logs/Claude(macOS),%APPDATA%\Claude\logs(Windows) or~/.config/Claude/logs(Linux). mcp.logshows connections;mcp-server-NAME.logholds each server's error output.- Check the JSON for syntax errors and use absolute paths.
- Run the server's command in a terminal to see whether it starts on its own.
Claude Desktop MCP questions
Where is the Claude Desktop config file?
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json. Windows: %APPDATA%\Claude\claude_desktop_config.json. Linux: ~/.config/Claude/claude_desktop_config.json. Open it from Settings → Developer → Edit Config.
How do I add an MCP server to Claude Desktop?
Add an entry under mcpServers in the config file, save it, then fully quit and restart the app. Each HostedMCP server page has the JSON.
How do I know the server loaded?
Open "Add files, connectors, and more" in the chat box, then Connectors → Manage connectors, and look for your server.
Can Claude Desktop use remote MCP servers?
Remote servers are added as connectors in the app rather than in the config file.
Popular MCP servers for Claude Desktop
- 1
Transcribe local audio files to text using SenseVoiceSmall with private, on-device inference.
Config for Claude Desktop
claude_desktop_config.json{ "mcpServers": { "funasr-mcp": { "command": "docker", "args": [ "run", "-i", "--rm", "ghcr.io/modelscope/funasr-mcp:0.1.2" ] } } } - 2
Lets an AI agent draw and edit draw.io diagrams on a live browser canvas that you can also edit by hand.
Config for Claude Desktop
claude_desktop_config.json{ "mcpServers": { "next-ai-drawio": { "command": "npx", "args": [ "-y", "@next-ai-drawio/mcp-server" ] } } } - 3
Search local screen recordings, audio transcriptions, and computer activity to control your computer with AI.
Config for Claude Desktop
claude_desktop_config.json{ "mcpServers": { "screenpipe-mcp": { "command": "npx", "args": [ "-y", "screenpipe-mcp" ] } } } - 4
Enables AI clients to search, view, and create issues and content within Atlassian Jira, Confluence, and Bitbucket Data Center instances.
Config for Claude Desktop
claude_desktop_config.json{ "mcpServers": { "atlassian-dc-mcp-jira": { "command": "npx", "args": [ "-y", "@atlassian-dc-mcp/jira" ] } } } - 5
Allows an AI client to access and manage content within Atlassian Data Center products including Jira, Confluence, and Bitbucket.
Config for Claude Desktop
claude_desktop_config.json{ "mcpServers": { "atlassian-dc-mcp-confluence": { "command": "npx", "args": [ "-y", "@atlassian-dc-mcp/confluence" ] } } } - 6
Give AI agents access to Gmail, Calendar, Drive, Docs, Sheets, Tasks, Meet, and Contacts across multiple accounts.
Config for Claude Desktop
claude_desktop_config.json{ "mcpServers": { "google-workspace-mcp": { "command": "npx", "args": [ "-y", "@aaronsb/google-workspace-mcp" ] } } } - 7
Connect MCP clients to Mindwtr tasks via local SQLite databases, a desktop Local API, or self-hosted Cloud endpoints.
Config for Claude Desktop
claude_desktop_config.json{ "mcpServers": { "mindwtr": { "command": "npx", "args": [ "-y", "mindwtr-mcp" ] } } } - 8
Lets an AI client read, search, and edit notes within an Obsidian vault directly through local file operations.
Config for Claude Desktop
claude_desktop_config.json{ "mcpServers": { "mcpvault": { "command": "npx", "args": [ "-y", "@bitbonsai/mcpvault" ] } } } - 9
Connects Mac and Windows apps like email, calendar, messages and files to AI assistants so they can read context and take actions.
Config for Claude Desktop
claude_desktop_config.json{ "mcpServers": { "local-mcp-releases": { "command": "npx", "args": [ "-y", "local-mcp" ] } } } - 10
Allows an AI client to access Cronometer nutrition data, manage food logs, track macros, biometrics, fasting, and recurring food entries.
Config for Claude Desktop
claude_desktop_config.json{ "mcpServers": { "cronometer-mcp": { "command": "uvx", "args": [ "cronometer-mcp" ] } } } - 11
Lets an AI client record and resume working notes, decisions, evidence, and risks using a durable SQLite backend.
Config for Claude Desktop
claude_desktop_config.json{ "mcpServers": { "mcp-sequential-thinking": { "command": "uvx", "args": [ "mcp-sequential-thinking" ] } } } - 12
Lets an AI client draw and edit draw.io diagrams on a live canvas from chat prompts and exports them as .drawio, .png or .svg files.
Config for Claude Desktop
claude_desktop_config.json{ "mcpServers": { "next-ai-draw-io": { "command": "npx", "args": [ "-y", "@next-ai-drawio/mcp-server" ] } } }