Skip to content
MCP server

kleinanzeigen-mcp

Search Kleinanzeigen.de, Germany's largest classifieds site, for second-hand listings

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.1.0
Listing updated
4 days ago

About kleinanzeigen-mcp

kleinanzeigen-mcp is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add kleinanzeigen -- npx -y kleinanzeigen-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "kleinanzeigen": {
      "command": "npx",
      "args": [
        "-y",
        "kleinanzeigen-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "kleinanzeigen": {
      "command": "npx",
      "args": [
        "-y",
        "kleinanzeigen-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "kleinanzeigen": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "kleinanzeigen-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "kleinanzeigen": {
      "command": "npx",
      "args": [
        "-y",
        "kleinanzeigen-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "kleinanzeigen": {
      "command": "npx",
      "args": [
        "-y",
        "kleinanzeigen-mcp"
      ]
    }
  }
}

Configuration

  • WILLMEHR_MODE'full' (default) for a local install; 'public' paces requests and lowers the page and batch caps for an instance shared by several people.
  • KZ_MIN_INTERVAL_MSMinimum spacing between requests to kleinanzeigen.de, in milliseconds. Concurrency trips the site's bot detection, so requests are serialised.
  • KZ_MAX_PAGE_COUNTCap on result pages a single search may fetch, roughly 25 listings each.
  • KZ_MAX_BATCH_SIZECap on listing ids per batch detail call.
  • TZListing timestamps are printed without a timezone; set Europe/Berlin to interpret them exactly.

Pricing

Open source

kleinanzeigen-mcp FAQ

Is kleinanzeigen-mcp free?

Yes. kleinanzeigen-mcp is open source, so you can use and self-host it for free.

How do I add kleinanzeigen-mcp to Claude Code?

Run this command in your terminal: claude mcp add kleinanzeigen -- npx -y kleinanzeigen-mcp