Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Idealista MCP Server Show all my active Idealista listings with prices, views, and days online."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
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.
Related MCP server: @inssist/mcp
Get your API key at https://cotlet.dev/app and export it as COTLET_API_KEY.
claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"Settings → Apps → add connector URL https://cotlet.dev/mcp/v1, then sign in with Cotlet.dev. No API key needed.
Copy .cursor/mcp.json from this repo into your project:
{
"mcpServers": {
"cotlet": {
"url": "https://cotlet.dev/mcp/v1",
"headers": {
"Authorization": "Bearer ${COTLET_API_KEY}"
}
}
}
}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.
{"mcpServers":{"idealista":{"command":"uvx","args":["idealista-mcp"],"env":{"COTLET_API_KEY":"your-key"}}}}Or with Docker:
docker build -t idealista-mcp .
docker run -i --rm -e COTLET_API_KEY idealista-mcpTools: 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".
Python 3.10+, nothing else to install. From PyPI:
pip install idealista-mcp # or run it once: uvx idealista-mcp connect
idealista-mcp connectOr straight from this repo:
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)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.
Start free: https://cotlet.dev/signup?app=idealista&utm_source=github&utm_medium=readme&utm_campaign=idealista
Click a numbered element on the current Idealista page.
Inputs: element (required).
Close the Idealista browser session when the work is done, so credits stop running.
Inputs: no named parameters.
How to work in Idealista (list and update your listings): its screens and the sign-in link. Call this first.
Inputs: task.
Open a Idealista page in your signed-in Cloud Browser (default https://www.idealista.com) to work with list and update your listings.
Inputs: url.
Read the current Idealista page: its text and numbered buttons, links and fields.
Inputs: element.
Check that your Cotlet.dev account and Idealista are ready: account, credits and Idealista connection.
Inputs: no named parameters.
Type text into a numbered field on the current Idealista page.
Inputs: text (required), element (required).
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 7 tools
The tools form a clear browser-automation loop (open → read → click/type → close) with distinct roles. The only soft overlap is between idealista_guide and idealista_status, since both are 'call first' onboarding/readiness checks, which could cause hesitation about which to invoke initially.
All seven tools use the same vendor-prefixed snake_case pattern (idealista_verb), with consistent verb-style suffixes (guide, status, open, read, click, type, close). No mixed conventions or casing deviations.
Seven tools is well-scoped for a browser-driven listing-management wrapper: each one maps to a distinct step (guidance, status, session lifecycle, and page interaction primitives). Nothing feels redundant or bloated.
The core session lifecycle and interaction primitives are covered, but the browser-control surface has notable gaps: no scroll, no select/dropdown handling, no keypress/submit, and no screenshot or wait-for-load. Since the actual listing create/update operations must be reproduced through this thin primitive set, agents may hit dead ends on common Idealista form flows.
Immobiliare.it MCP server for ChatGPT, Claude and any AI agent: list my listings, create listing, reply to message, request visit and save search in your own Immobiliare.it account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Immobiliare.it yourself; Cotlet does not store your password and you need no Immobiliare.it API key. About the official Immobiliare.it API: Immobiliare.it has no public API for listings, messages or visit requests (checked 11 Oct 2026). Agencies get listings onto the portal only through agency management software such as Getrix Multinvio, and everyone else manages listings and Messages by hand in their personal area. Setup and FAQ: https://cotlet.dev/integrations/immobiliare-api-mcp-server
Let your AI agent operate any website through a real, logged-in browser session.
Let AI agents use your real, signed-in Chrome: tabs, clicks, forms, screenshots and video.
Let AI agents use any website you're logged in to. Sessions stay encrypted on your machine.
