DEV Community

KazKN
KazKN

Posted on • Edited on

How to Install Vinted MCP Server in Claude Desktop (2026)

#vinted #ai #mcp #tutorial

How to Install Vinted MCP Server in Claude Desktop (2026)

Last updated: February 15, 2026 | Reading time: 10 min

You've heard about MCP servers giving Claude superpowers — the ability to search databases, control browsers, and pull live data from anywhere. Now you want Claude to search Vinted for you. The setup takes exactly 4 minutes and 3 commands.

The Vinted MCP Server is the simplest way to give Claude Desktop real-time access to Vinted's marketplace across 19 countries. Once installed, you can ask Claude to find specific items, compare prices, analyze sellers, and run market research — all in natural language, all without opening a browser.

According to the MCP specification, the Model Context Protocol is supported by over 50 AI tools as of 2026, making it the de facto standard for connecting AI to external data. Claude Desktop was the first client to support MCP, and it remains the most polished integration.

In this guide, you'll learn:

  • Exact copy-paste commands to install the Vinted MCP Server
  • Claude Desktop configuration for macOS and Windows
  • Verification steps to confirm everything works
  • Troubleshooting for common issues

Table of Contents

  1. Prerequisites
  2. Step 1: Install Node.js
  3. Step 2: Install the MCP Server
  4. Step 3: Configure Claude Desktop
  5. Step 4: Verify the Installation
  6. Troubleshooting
  7. Your First Vinted Queries
  8. FAQ

Prerequisites {#prerequisites}

Before starting, you need:

  • Claude Desktop installed and running (download here)
  • Node.js 18 or higher installed on your machine
  • A working internet connection

That's it. No API keys required. No Vinted account needed. No payment information.

Step 1: Install Node.js {#install-node}

If you already have Node.js 18+, skip to Step 2.

Check if Node.js is installed:

node --version
Enter fullscreen mode Exit fullscreen mode

If you see v18.x.x or higher, you're good. If not:

macOS (using Homebrew):

brew install node
Enter fullscreen mode Exit fullscreen mode

Windows (using installer):
Download from nodejs.org and run the installer. Choose the LTS version.

Linux (Ubuntu/Debian):

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
Enter fullscreen mode Exit fullscreen mode

Verify installation:

node --version  # Should show v18+ 
npm --version   # Should show 9+
Enter fullscreen mode Exit fullscreen mode

Step 2: Install the MCP Server {#install-mcp}

One command:

npm install -g vinted-mcp-server
Enter fullscreen mode Exit fullscreen mode

This installs the Vinted MCP Server globally on your machine. The package is lightweight (~2 MB) and has minimal dependencies.

Verify it installed correctly:

npx vinted-mcp-server --help
Enter fullscreen mode Exit fullscreen mode

You should see the server's help output with available commands and options.

Step 3: Configure Claude Desktop {#configure-claude}

Now tell Claude Desktop where to find the Vinted MCP Server.

macOS

Open Terminal and run:

# Create the config directory if it doesn't exist
mkdir -p ~/Library/Application\ Support/Claude

# Open the config file (creates it if needed)
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
Enter fullscreen mode Exit fullscreen mode

Paste this configuration:

{
  "mcpServers": {
    "vinted": {
      "command": "npx",
      "args": ["vinted-mcp-server"]
    }
  }
}
Enter fullscreen mode Exit fullscreen mode

Save the file (Ctrl+O, Enter, Ctrl+X in nano).

If you already have other MCP servers configured, add the "vinted" entry inside the existing "mcpServers" object:

{
  "mcpServers": {
    "existing-server": {
      "command": "...",
      "args": ["..."]
    },
    "vinted": {
      "command": "npx",
      "args": ["vinted-mcp-server"]
    }
  }
}
Enter fullscreen mode Exit fullscreen mode

Windows

Open File Explorer and navigate to:

%APPDATA%\Claude\
Enter fullscreen mode Exit fullscreen mode

Open or create claude_desktop_config.json and paste the same configuration:

{
  "mcpServers": {
    "vinted": {
      "command": "npx",
      "args": ["vinted-mcp-server"]
    }
  }
}
Enter fullscreen mode Exit fullscreen mode

Important: Restart Claude Desktop

Close Claude Desktop completely (quit from the menu bar, not just close the window). Then reopen it. Claude needs to restart to detect the new MCP server.

Step 4: Verify the Installation {#verify}

Once Claude Desktop reopens, look for the hammer icon (🔨) in the input area. Click it — you should see "vinted" listed among your available tools.

Run a test query:

Type in Claude:

"Search for Nike sneakers under €40 on Vinted France"

If Claude returns a list of Vinted listings with prices, titles, and URLs — congratulations, you're set up!

If Claude says it can't access Vinted or doesn't recognize the tool, see the Troubleshooting section below.

🎯 That's it. Four minutes, three commands. The Vinted MCP Server is now active in your Claude Desktop. Every conversation can access Vinted data.

Troubleshooting {#troubleshooting}

"Claude doesn't show the Vinted tool"

Check 1: Did you restart Claude Desktop completely? (Quit → Reopen, not just close window)

Check 2: Verify the config file path is correct:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Check 3: Validate JSON syntax. A missing comma or bracket breaks the entire config. Use jsonlint.com to check.

Check 4: Verify npm is in Claude's PATH. Try using the full npx path:

{
  "mcpServers": {
    "vinted": {
      "command": "/usr/local/bin/npx",
      "args": ["vinted-mcp-server"]
    }
  }
}
Enter fullscreen mode Exit fullscreen mode

On macOS, find your npx path with: which npx

"Claude shows the tool but queries fail"

Check 1: Internet connection — the MCP server needs to reach Vinted's servers.

Check 2: Try running the server manually to see error output:

npx vinted-mcp-server
Enter fullscreen mode Exit fullscreen mode

Check 3: Update to the latest version:

npm update -g vinted-mcp-server
Enter fullscreen mode Exit fullscreen mode

"Node.js command not found"

Your shell can't find Node.js. This commonly happens after installing Node.js without restarting your terminal.

Fix: Close and reopen your terminal, then try again. If still failing, check that Node.js is in your PATH:

export PATH="/usr/local/bin:$PATH"  # macOS
Enter fullscreen mode Exit fullscreen mode

"Permission denied during npm install"

On macOS/Linux, don't use sudo npm install -g. Instead, fix npm permissions:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc
npm install -g vinted-mcp-server
Enter fullscreen mode Exit fullscreen mode

Your First Vinted Queries {#first-queries}

Now that the MCP server is installed, here are queries to try:

Deal Finding

"Find the cheapest Nike Air Force 1 in size 42 on Vinted Germany"

Price Comparison

"What's the average price of Levi's 501 jeans on Vinted France vs Vinted Poland?"

Market Research

"Show me the most expensive Gucci items currently listed on Vinted Italy under €200"

Seller Research

"Find Nike Dunk Low listings on Vinted France from sellers with 4.8+ rating"

Arbitrage Research

"Compare prices of Adidas Samba across Vinted Spain, France, and Netherlands. Where is it cheapest?"

For deep cross-border arbitrage analysis, combine MCP queries with bulk data from the Vinted Smart Scraper.

Category Analysis

"What are the 10 most common sneaker brands listed on Vinted France right now?"

This kind of category analysis helps you identify which brands to focus on for reselling.

Following Up

The best part of MCP: conversation context. After your first query, ask follow-up questions:

"Of those results, which ones are from sellers with more than 100 reviews?"
"Sort those by price, lowest first"
"How much would I profit if I bought the cheapest one and sold it in Italy?"

Claude remembers the previous results and builds on them.

Beyond Claude Desktop: Other AI Tools {#other-tools}

Cursor IDE

Add to your Cursor settings (.cursor/mcp.json):

{
  "servers": {
    "vinted": {
      "command": "npx",
      "args": ["vinted-mcp-server"]
    }
  }
}
Enter fullscreen mode Exit fullscreen mode

Now query Vinted while coding — useful for developers building price tools or reselling automation.

Windsurf

Windsurf supports MCP servers with similar configuration. Check Windsurf's documentation for the exact config file location.

Apify Hosted Version

If you prefer not to run the server locally, use the hosted version on Apify. It runs in the cloud and connects to your AI tool via the Apify MCP gateway.

Comparison: MCP Setup Methods

Method Setup Time Requires Node.js Local/Cloud Cost
npm global install (this guide) 4 minutes Yes Local Free
npx (no install) 2 minutes Yes Local Free
Apify hosted 3 minutes No Cloud Free tier ($5/mo)
Docker 10 minutes No (Docker required) Local Free

For most users, the npm global install described in this guide is the best balance of simplicity and reliability.

FAQ {#faq}

Do I need a Vinted account to use the MCP Server?

No. The Vinted MCP Server searches publicly available Vinted listings without requiring authentication. You don't need a Vinted account, API key, or login credentials.

Is the Vinted MCP Server free?

Yes. The MCP server is open-source and free to use. It's published on npm and GitHub under an open license. No subscription, no usage limits, no credit card.

Does the MCP Server work with Claude Pro and Free?

Yes. The Vinted MCP Server works with both Claude Pro and Claude Free through Claude Desktop. The MCP protocol works at the client level — it doesn't depend on your Claude subscription tier.

Can I use the MCP Server for bulk data extraction?

The MCP server is optimized for interactive queries (10-50 results per query). For bulk extraction of hundreds or thousands of listings, use the Vinted Smart Scraper on Apify. The two tools complement each other — scraper for bulk, MCP for interactive research.

Which Vinted countries does the MCP Server support?

All 19 Vinted country domains: France, Germany, Netherlands, Poland, Italy, Spain, Belgium, Lithuania, Czech Republic, Sweden, Austria, Portugal, Denmark, Finland, Hungary, Romania, Slovakia, Croatia, and Luxembourg. Specify the country in your query.

How do I update the MCP Server to the latest version?

Run npm update -g vinted-mcp-server and restart Claude Desktop. Check the GitHub releases page for changelogs.

Can I use this with Cursor IDE for development?

Yes. Cursor supports MCP servers natively. Add the Vinted MCP configuration to your Cursor MCP settings and query Vinted data while coding. This is useful for developers building scraping tools, price comparison apps, or reselling automation.

What if Claude doesn't return any results?

Check that: (1) the MCP server appears in Claude's tools menu, (2) your internet connection is working, (3) your query specifies a valid Vinted country. If issues persist, try running npx vinted-mcp-server in terminal to see any error messages, and check the GitHub issues page.

How does this relate to the App Store Scraper?

The App Store Scraper is a separate Apify tool for mobile app market intelligence. Both tools follow the same philosophy: making marketplace data accessible through automation. The Vinted MCP Server focuses on fashion marketplace data for Claude AI.

Start Searching Vinted From Claude Today

Three commands. Four minutes. Unlimited Vinted market research from your AI assistant.

npm install -g vinted-mcp-server
Enter fullscreen mode Exit fullscreen mode

Then configure Claude Desktop and start asking questions.

Resources:

For bulk data extraction, combine with the Vinted Smart Scraper.

Related reading:

Top comments (0)