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
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?
- Open Notepad
- Type
{} - File โ Save As โ navigate to
%APPDATA%Claude - Change "Save as type" to All Files (*.*)
- Save as
claude_desktop_config.json
.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"]
}
}
}
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
- Save โ Ctrl + S
- Fully quit Claude Desktop โ right-click tray icon โ Quit, or use Task Manager to end the process
- Reopen from Start Menu or taskbar
Windows vs Mac: Key Differences
| Aspect | Windows | Mac |
|---|---|---|
| Config location | %APPDATA%Claude | ~/Library/Application Support/Claude/ |
| Paths in JSON | Double backslash \\ | Forward slash / |
| npx binary name | npx.cmd | npx |
| Default text editor | Notepad โ use "All Files" when saving | TextEdit โ 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.
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.