Documentation
idealista for Claude
1. About
idealista provides an official app for Claude that lets you search real estate listings and get information from idealista directly inside your conversation. It is only available through the official idealista connector approved for Claude, and it does not support manual configuration from other MCP clients.
2. Availability and languages
- Countries: Spain, Italy, and Portugal.
- Languages: Spanish, English, Italian, and Portuguese.
The language of your conversation can be different from the country where you are searching for properties.
3. How to use idealista in Claude
- Connect the official idealista app from the connector directory.
- Enable idealista for your conversation from the connectors menu.
- Ask for what you need using natural language.
Claude can automatically choose idealista when your request matches its capabilities. You can also mention it explicitly, for example: “Using idealista, find apartments for rent in Madrid.”
You don’t need to know or call any tool directly — just describe what you want.
For general instructions on connecting apps in Claude, see Use connectors to extend Claude’s capabilities.
4. What you can do
- Search for properties on idealista. Results are shown as a browsable carousel, which you can expand into a map view to see listings by location.
- The results carousel and map view work on mobile and desktop, and support both light and dark mode.
- Ask idealista to sort results — for example, “the cheapest first” or “the most recent first” — using the same sorting options already available on idealista’s website. If you don’t ask for a specific order, results are sorted by relevance.
- Search results and listing details always reflect the information currently published on idealista.
- Get information about a specific listing directly, by giving its idealista URL or listing ID — no search needed. You can also ask about one of the properties from your search results or from the map view.
- Get help with tasks on idealista’s website, based on its help content — currently, how to publish a listing. The app can explain how to complete these tasks, but it cannot perform them on your behalf.
- Learn about the app’s capabilities and how to get started.
5. Available tools
| Tool | Purpose |
|---|---|
search_properties |
Searches for properties on idealista. |
property_detail |
Retrieves information about a specific idealista listing. |
get_howto |
Explains how to complete tasks on idealista’s website, based on its help content (currently: how to publish a listing). |
guide_idealista_assistant |
Explains what the idealista app can do and how to get started. |
6. How search results are displayed
You can search in any of the available languages, regardless of the country: the country is determined by the location you mention, not by the language of your prompt. Results always follow the same flow — inline carousel, map view, listing detail — illustrated below with prompts in different languages.
Inline carousel. Search results first appear as a carousel with price, size, rooms, and features for each result, plus a link to see the full search on idealista. For example, in Spanish:
“Usando idealista, busca viviendas en alquiler en Malasaña-Universidad, Madrid.”
Map and list view. Selecting “view on map” expands the carousel into a split view, with the list on one side and the locations on a map on the other. For example, in Portuguese:
“Usando o idealista, procura garagens para arrendar em Lisboa.”
Listing detail. Selecting a listing — or asking about one of the results — opens its detail with price, size, rooms, features, images, location, and status, without starting a new search. For example, in Italian:
“Usando idealista, mostrami i dettagli della camera in viale Giovanni Milton tra i risultati.”
7. Example prompts
Example 1 - Search and refine results
User prompt:
“Using idealista, I’m looking for a 2-bedroom apartment to rent in Rome for less than 2,000 euros a month.”
How Claude responds:
- Claude searches idealista for matching rental apartments in Rome.
- Returns an inline carousel with price, size, rooms, and features for each result, which you can expand into a map view.
- Includes a link to see the full search on idealista.
You can ask follow-up questions such as:
“Show me the cheapest ones first.” “Show only the ones with a garden.” “Tell me more about the second one.”
If you ask for a specific order — for example, “the cheapest first” or “the most recent first” — idealista sorts results using the same options already available on its website. Without a sorting request, results are sorted by relevance.
Expected behavior
You receive matching rental listings that you can browse as a carousel or on a map, and refine further — including by sorting — with follow-up questions.
Example 2 - Get details about a specific listing
User prompt:
“Summarize the strengths and weaknesses of this listing: https://www.idealista.com/inmueble/12345678/”
How Claude responds:
- Claude retrieves the current details of that listing from idealista — price, size, rooms, features, images, location, and status.
- Summarizes its strengths and weaknesses based on that information, without starting a new search.
Expected behavior
You receive a summary based on the listing’s real, current information.
Example 3 - Get help with a task on idealista’s website
User prompt:
“How do I publish a listing on idealista?”
How Claude responds:
- Claude returns a step-by-step guide based on idealista’s help content, including prerequisites and related links.
Expected behavior
You get an explanation of how to publish a listing; idealista does not publish anything on your behalf.
Example 4 - Learn what idealista can do
User prompt:
“Using idealista, what can you help me with?”
How Claude responds:
- Claude explains the idealista app’s capabilities and how to get started.
Expected behavior
You receive an overview of what you can do, without idealista taking any action.
Example 5 - Location is missing or too vague
User prompt:
“Using idealista, I’m looking for a home 5 minutes from my house.”
How Claude responds:
- idealista asks you to specify a concrete location — a city, neighborhood, or address — since it can’t search based on your current location.
Expected behavior
Claude asks a clarifying question instead of returning results.
8. Permissions and limitations
- All tools are read-only.
- No login or idealista account linking is required.
- The app does not publish, edit, or delete listings.
- The app does not manage favorites, alerts, or messages.
- The app does not perform any transactions.