# Idealista MCP Server and API by Cotlet

> Idealista MCP Server and API by Cotlet is an MCP server for productivity. Unofficial Idealista MCP server to manage your own ads, inbox contacts and prices. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Platforms:** API, Web
- **Website:** https://cotlet.dev/integrations/idealista-api-mcp-server
- **Repository:** https://github.com/cotlet-connect/idealista-mcp
- **MCP Registry name:** dev.cotlet/idealista
- **Categories:** productivity, sales and CRM
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://cotlet.dev/mcp/v1/idealista/connect
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "idealista": {
      "url": "https://cotlet.dev/mcp/v1/idealista/connect"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [MisarReach MCP Server](https://ai-powered.com/mcp/misarreach-mcp-server): MisarReach MCP Server is a freemium MCP server for sales and crm.
- [NeuralVerge](https://ai-powered.com/mcp/neuralverge): NeuralVerge is an MCP server for web search and scraping.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.

---
Source: https://ai-powered.com/mcp/idealista-mcp-server-and-api-by-cotlet
