How to connect Idealista to Claude Code, ChatGPT and any AI agent

Name: Idealista MCP Server and API by Cotlet
Author: cotlet

Yes, Claude, ChatGPT and other AI agents can work in your Idealista account. Idealista's official ChatGPT app and Claude connector search properties to buy or rent in Spain, Italy and Portugal. Cotlet.dev connects your own signed-in Idealista account to any AI agent, so the AI lists, checks and updates your listings for you.

What you can ask

List all my active listings with price, views and days online.

Lower the price of the flat on Calle Alcalá 120 in Madrid from €385,000 to €369,000.

Rewrite the description of my two-bedroom in Lisbon to highlight the new kitchen and the terrace. Show me the draft first.

Which of my listings got no contacts in the last 14 days? Sort them by price.

Add the 6 new photos to my Barcelona loft listing and put the terrace photo first.

Connect in 2 minutes

Get your API key at https://cotlet.dev/app and export it as COTLET_API_KEY.

Claude Code

bash

claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"

ChatGPT

Settings → Apps → add connector URL https://cotlet.dev/mcp/v1, then sign in with Cotlet.dev. No API key needed.

Cursor

Copy .cursor/mcp.json from this repo into your project:

json

{
  "mcpServers": {
    "cotlet": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": {
        "Authorization": "Bearer ${COTLET_API_KEY}"
      }
    }
  }
}

Run it locally (stdio)

This repo is a real MCP server. It speaks MCP over stdio, lists its Idealista tools without any key, and forwards every tool call to the hosted Cotlet.dev server. The hosted URL above stays the recommended way. Use this when your client only starts local servers.

json

{"mcpServers":{"idealista":{"command":"uvx","args":["idealista-mcp"],"env":{"COTLET_API_KEY":"your-key"}}}}

Or with Docker:

bash

docker build -t idealista-mcp .
docker run -i --rm -e COTLET_API_KEY idealista-mcp

Tools: idealista_guide, idealista_status, idealista_open, idealista_read, idealista_click, idealista_type, idealista_close. Without COTLET_API_KEY a tool call answers: "Set COTLET_API_KEY. Get a key at https://cotlet.dev/app".

Command line

Python 3.10+, nothing else to install. From PyPI:

bash

pip install idealista-mcp        # or run it once: uvx idealista-mcp connect
idealista-mcp connect

Or straight from this repo:

bash

export COTLET_API_KEY="your-key"
python3 idealista_agent.py connect   # ready config for Claude Code, Cursor, ChatGPT
python3 idealista_agent.py status    # is Idealista ready in your Cotlet.dev account
python3 idealista_agent.py guide     # Idealista screens and sign-in link
python3 idealista_agent.py read      # open Idealista, read the page, close the browser
python3 idealista_agent.py tools     # list Cotlet.dev tools
python3 idealista_agent.py serve     # start the stdio MCP server (same as no argument)

Questions from Idealista users

Does Idealista have an API?

Idealista has no public API for your own listings or contacts (checked 11 Oct 2026). Its Search API is read-only and given only after an application, and its official Claude and ChatGPT app only searches public listings, with no login. Cotlet.dev works in your own signed-in Idealista account, so your AI agent can list and update your listings with no API key and no code.

How do I connect Idealista to ChatGPT?

Idealista's official ChatGPT app searches properties. To work with your own listings, add Cotlet.dev as an app in ChatGPT (Settings → Apps, connector URL https://cotlet.dev/mcp/v1), sign in to Idealista once in your Cotlet.dev Cloud Browser, and ask ChatGPT in plain words. No code and no Idealista API key.

Is there a way to use Claude with Idealista?

Yes. Idealista's own Claude connector covers property search. To manage your listings, run the one-line claude mcp add command above in Claude Code, or add https://cotlet.dev/mcp/v1 as a custom connector in the Claude app. Claude then works in your own Idealista account.

Is there an Idealista MCP server?

Idealista's official connectors focus on property search in Spain, Italy and Portugal. Cotlet.dev is a hosted MCP server that works in your own Idealista account for you, 24/7, with Claude, ChatGPT, Cursor, Codex, n8n, Make and Zapier.