Skip to content
MCP server

Idealista MCP Server and API by Cotlet

Unofficial Idealista MCP server to manage your own ads, inbox contacts and prices

Install
Pricing
Free trial
Platforms
API, Web
Runs
Remotely
Version
1.0.2
Listing updated
2 days ago

About Idealista MCP Server and API by Cotlet

Idealista MCP Server and API by Cotlet is an MCP server for productivity. It runs as a hosted remote server, so there is nothing to install locally.

Idealista's official ChatGPT and Claude app and its Search API only read public listings. This Cotlet server is aimed at the other side: a private advertiser or agency managing its own account. Its 14 tools list your active ads with visits, contacts and favorites over 7, 30 or 90 days, read and answer Inbox contacts, change a price, and deactivate or reactivate an ad.

Changes wait for your OK. Cotlet notes that it works through your own signed-in account in a cloud browser, and recommends the official app for searching public listings instead. The README prompts include lowering a price, rewriting a description as a draft first and finding ads with no contacts in 14 days.

It is unofficial and not affiliated with Idealista. Agents use MCP and scripts use REST, billed in Cotlet credits.

Install

Run in a terminal

claude mcp add --transport http idealista https://cotlet.dev/mcp/v1/idealista/connect

Add to Settings → Connectors → Add custom connector

https://cotlet.dev/mcp/v1/idealista/connect
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "idealista": {
      "url": "https://cotlet.dev/mcp/v1/idealista/connect"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "idealista": {
      "type": "http",
      "url": "https://cotlet.dev/mcp/v1/idealista/connect"
    }
  }
}

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

{
  "mcpServers": {
    "idealista": {
      "serverUrl": "https://cotlet.dev/mcp/v1/idealista/connect"
    }
  }
}

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

{
  "mcpServers": {
    "idealista": {
      "type": "http",
      "url": "https://cotlet.dev/mcp/v1/idealista/connect"
    }
  }
}

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

idealista_guide
Shows the app's screens and the sign-in link.
idealista_status
Reports whether the app is ready in your Cotlet account.
idealista_open
Opens the app in your Cotlet cloud browser.
idealista_read
Reads the current page, then closes the browser.
idealista_click
Clicks an element in the signed-in session.
idealista_type
Types text into a field in the signed-in session.
idealista_close
Closes the cloud browser session.

What it does

Your ads and stats
Lists ads with visits, contacts and favorites for 7, 30 or 90 days.
Inbox contacts
Reads and answers contacts after your OK.
Price changes
Lowers or changes an ad's price on request.
Activate and deactivate
Takes a rented flat off Idealista or puts it back.
Draft edits
Rewrites descriptions, with a draft shown first.
MCP and REST
Same 14 tools for agents and scripts.

Good for

  • Answer new Inbox contacts
  • Offer viewing slots to leads
  • Spot ads with visits but no contacts
  • Lower a price after approval
  • Take a rented flat off the listing

Pricing

Free trial

7-day trial with 2,000 credits, no card. After that, credit packs from $29 one time (5,000 credits), valid 12 months; most calls cost 10 credits

Prices change. Check cotlet.dev before you buy.

Idealista MCP Server and API by Cotlet FAQ

Is there an official Idealista tool?

Yes, an app in ChatGPT and Claude and a Search API, but both read public listings only, according to Cotlet.

Can this search public listings?

No; the page says to use the official app for that.

Is it affiliated with Idealista?

No, it is unofficial.

How does it log in?

You sign in to your own Idealista account in a Cotlet cloud browser.

Is Idealista MCP Server and API by Cotlet free?

Idealista MCP Server and API by Cotlet is a paid product with a free trial.

How do I add Idealista MCP Server and API by Cotlet to Claude Code?

Run this command in your terminal: claude mcp add --transport http idealista https://cotlet.dev/mcp/v1/idealista/connect

What are the best alternatives to Idealista MCP Server and API by Cotlet?

The closest alternatives to Idealista MCP Server and API by Cotlet are Ha MCP, Concord MCP, Calven, CompanyData and note1.

Alternatives to Idealista MCP Server and API by Cotlet

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. Calven

    MCP server

    Product marketing context from Calven delivered into Claude, ChatGPT and other AI tools

    Not checked yet
    • Remote
    • Free trial
    • 3 GitHub stars
    • Marketing and SEO
  4. CompanyData

    MCP server

    Search and enrich company records from official registers via the CompanyData API

    • 3 tools
    • Remote
    • Paid
    • 3 GitHub stars
    • Analytics and data
  5. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  6. Find, enrich and score B2B leads and run outreach sequences from an AI assistant

    • 31 tools
    • Remote
    • Freemium
    • 1 GitHub star
    • Sales and CRM