Install MCP Claude Desktop Linux: Config & Setup Guide

Linux adds one gotcha that catches almost everyone who uses nvm: Claude Desktop launches as a non-interactive process and doesn't inherit the shell PATH where nvm lives. Here's how to navigate that — plus the rest of the setup.

Prerequisites

• Claude Desktop (AppImage or .deb from claude.ai/download)
• Node.js: sudo apt install nodejs npm or via nvm (recommended)

Config File Location

Linux follows the XDG spec:

~/.config/Claude/claude_desktop_config.json

Setting Up

mkdir -p ~/.config/Claude
nano ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "weather": {
      "command": "npx",
      "args": ["-y", "@trustedskills/weather-mcp"]
    }
  }
}

Config Paths: Linux vs Everything Else

The nvm Problem — and Two Ways to Fix It

If you installed Node.js via nvm, you've probably noticed: nvm works great in your terminal, but Claude Desktop acts like Node doesn't exist. That's because nvm adds npx to your shell's PATH — but only for interactive shells. Claude Desktop launches non-interactively and never runs those shell initialisation scripts.

Fix Option 1: Full path (most reliable)

which npx
# /home/yourname/.nvm/versions/node/v20.11.0/bin/npx

{
  "mcpServers": {
    "weather": {
      "command": "/home/yourname/.nvm/versions/node/v20.11.0/bin/npx",
      "args": ["-y", "@trustedskills/weather-mcp"]
    }
  }
}

Fix Option 2: Add nvm to non-interactive profile

Add to ~/.profile:

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"

Log out and back in, then restart Claude Desktop.

Checking Logs

tail -f ~/.config/Claude/logs/mcp*.log

Frequently Asked Questions

Where is the Claude Desktop config on Linux?

At ~/.config/Claude/claude_desktop_config.json, following XDG spec. Create the directory first: mkdir -p ~/.config/Claude.

Why can't Claude Desktop find npx on Linux?

Almost always nvm. Claude Desktop launches non-interactively and doesn't inherit the shell PATH where nvm puts its binaries. Use the full path to npx from which npx, or add nvm init to ~/.profile.

Does Claude Desktop work on all Linux distros?

The AppImage works on most distros. The .deb is for Ubuntu/Debian. MCP config setup is identical across all distributions.