Beginner

Install MCP Skills Claude Desktop Windows: Full Guide

Install MCP skills on Claude Desktop Windows step-by-step. Covers the config file location, JSON format, Windows path gotchas with npx, and troubleshooting tips for getting skills working.

๐Ÿ•Last updated 4 March 2026

โšก Quick Answer

Open %APPDATA%Claudeclaude_desktop_config.json, add your skill inside mcpServers, save, and fully restart Claude Desktop. If npx isn't found, run where npx in Command Prompt to get the full path โ€” then use that in your config.

Windows adds a couple of wrinkles that the Mac guide skips over โ€” Notepad's save-as-type trap, the double-backslash JSON requirement, and npx sometimes hiding from Claude Desktop even when it works fine in your terminal. Here's how to navigate all of it.

What You'll Need

  • Claude Desktop โ€” from claude.ai/download
  • Node.js โ€” LTS version from nodejs.org. The installer handles everything including npx.
  • A text editor โ€” Notepad works, VS Code is much better

Step 1: Find the Config File

Windows stores the Claude Desktop config here:

%APPDATA%Claudeclaude_desktop_config.json

Open it fast: press Windows + R, type %APPDATA%Claude, press Enter. Explorer opens right in the Claude config folder.

Or use Claude Desktop's shortcut: hamburger menu โ†’ Settings โ†’ Developer โ†’ Edit Config.

Step 2: Open the Config File

Right-click claude_desktop_config.json โ†’ Open With โ†’ Notepad or VS Code.

File doesn't exist?

  1. Open Notepad
  2. Type {}
  3. File โ†’ Save As โ†’ navigate to %APPDATA%Claude
  4. Change "Save as type" to All Files (*.*)
  5. Save as claude_desktop_config.json
โš ๏ธ Notepad trap: If you leave "Save as type" set to "Text Documents", Notepad adds a hidden .txt extension. Your file becomes claude_desktop_config.json.txt and Claude Desktop can't find it. Always select "All Files (*.*)" first.

Step 3: Add Your Skill

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

The backslash problem

If you ever need a local file path in your config, Windows backslashes must be doubled in JSON. C:UsersMe ool becomes C:\\Users\\Me\\tool. For skills installed via npx, you don't need any paths โ€” just the package name.

npx not in PATH?

Run this in Command Prompt:

where npx
# C:Program Files
odejs
px.cmd  โ† use this full path
{
  "mcpServers": {
    "weather": {
      "command": "C:\\Program Files\\nodejs\\npx.cmd",
      "args": ["-y", "@trustedskills/weather-mcp"]
    }
  }
}
๐Ÿ”ฌ From the field

We've seen this exact issue on almost every Windows machine where Node.js was installed using a non-standard location or an older installer that didn't add to PATH. Two minutes to find the path with where npx, update the config, and everything works. Don't reinstall Node โ€” just use the full path.

Step 4: Save and Restart

  1. Save โ€” Ctrl + S
  2. Fully quit Claude Desktop โ€” right-click tray icon โ†’ Quit, or use Task Manager to end the process
  3. Reopen from Start Menu or taskbar

Windows vs Mac: Key Differences

AspectWindowsMac
Config location%APPDATA%Claude~/Library/Application Support/Claude/
Paths in JSONDouble backslash \\Forward slash /
npx binary namenpx.cmdnpx
Default text editorNotepad โ€” use "All Files" when savingTextEdit โ€” switch to Plain Text mode

Troubleshooting

"npx is not recognized"

Node.js isn't in your PATH. Either reinstall Node.js with "Add to PATH" checked, or use the full npx path (see above).

JSON syntax errors

Notepad won't tell you when your JSON is broken. Use VS Code or jsonlint.com to validate.

Skill still not showing after restart

Check Task Manager โ€” Claude Desktop sometimes leaves a background process running after you "close" it. Kill all Claude processes, then reopen fresh.


Frequently Asked Questions

Where is the Claude Desktop config file on Windows?

At %APPDATA%Claudeclaude_desktop_config.json. Press Windows+R and type %APPDATA%Claude to open the folder directly.

Why do I need double backslashes in JSON on Windows?

Backslash is an escape character in JSON. A single tells JSON "the next character is special". To represent a literal backslash, you need \. For npx-based skills using package names, this doesn't matter โ€” no paths involved.

Claude Desktop won't find npx โ€” how do I fix it on Windows?

Run where npx in Command Prompt to get the full path, then use that as the "command" value. Remember to double every backslash in the JSON string.

TT

TrustedSkills Team

The TrustedSkills team builds and tests AI agent integrations across Claude, OpenClaw, Cursor, and VS Code. We verify every skill in our registry and have set up hundreds of MCP configs across every major platform.