Skip to main content
Free UK property data API Start free →
Claude Desktop • homedata-mcp v0.2.0

UK property data MCP for Claude Desktop

Anthropic's official desktop app for Claude. Install the Homedata MCP and Claude Desktop gains typed tools for 29 million UK properties — EPC, flood risk, planning, schools, transport — answered straight from your chat or agent.

Get a key Install in Claude Desktop ↓

Install the Homedata MCP in Claude Desktop

Three steps: install the Python package, drop in the config block, restart Claude Desktop.

Add to

~/Library/Application Support/Claude/claude_desktop_config.json

macOS — Linux uses ~/.config/Claude/, Windows uses %APPDATA%\Claude\.

{
  "mcpServers": {
    "homedata": {
      "command": "homedata-mcp",
      "env": {
        "HOMEDATA_API_KEY": "your_api_key_here"
      }
    }
  }
}
Restart Claude Desktop after saving. Your new MCP server appears in the slider menu next to the chat input.

1. Install the server

Python 3.10 or newer with pip on your PATH.

pip install homedata-mcp

2. Get your API key

Sign up free and copy your key from the developer dashboard. Paste it into HOMEDATA_API_KEY.

3. Restart Claude Desktop

Restart Claude Desktop after saving. Your new MCP server appears in the slider menu next to the chat input.

What your AI can ask about UK property

Typed tools Claude Desktop gains the moment the Homedata MCP is connected.

search_address Free

Type-ahead UK address search across all 29 million properties — find a UPRN in milliseconds.

lookup_property Included

Pull the full property record for any UK UPRN — characteristics, tenure, build period and more.

lookup_epc Included

Energy performance certificate rating, score and recommendations from the official EPC register.

lookup_flood_risk Included

River, sea, surface and groundwater flood risk for any UK address — sourced from the Environment Agency.

get_planning_applications Included

Recent planning applications for a postcode or local authority — applicant, description, status, decision dates.

get_crime Included

Crime statistics for the surrounding area, broken down by category and month.

get_schools Included

Nearby state and independent schools with Ofsted rating, type and distance.

get_transport Included

Closest rail, tube and tram stations with walking distance and line information.

get_postcode_profile Included

Aggregated profile for any UK postcode — sales activity, average prices, area scores.

batch_property_lookup Included

Look up multiple properties at once — pass a list of UPRNs, get back full property records for each.

search_property_listings Paid plans

Live UK property listings from Home.co.uk — for sale, to rent, sold STC, price changes.

get_property_sales Paid plans

Land Registry sale history for a property — every transaction since 1995 with price and date.

Tools call the same endpoints documented on /docs/endpoints. Property data sourced from Home.co.uk, Land Registry, EPC register, Environment Agency, ONS, Ofsted and other authoritative UK sources. Sales, listings and comparables are surfaced for customers on higher-tier plans — see plans.

What developers build with Claude Desktop and Homedata

Concrete jobs the Homedata MCP unlocks inside Claude Desktop.

Ask Claude for a one-paragraph risk summary on any UK address — EPC, flood, planning history — without leaving the chat.

Drop a postcode into Claude and ask for an investment thesis with schools, demographics and recent planning permissions.

Claude Desktop + Homedata MCP — frequently asked questions

How do I install the Homedata MCP in Claude Desktop?
Install the homedata-mcp Python package with pip install homedata-mcp, then open Claude Desktop, go to Settings → Developer → Edit Config, and add the homedata block to mcpServers. Drop in your free Homedata API key, save the file and restart the app. Claude will show homedata as a connected MCP server.
Does the Homedata MCP work with Claude Desktop on Windows and Linux?
Yes. The same Python package runs on macOS, Windows and Linux. The only difference is the path to claude_desktop_config.json — macOS uses ~/Library/Application Support/Claude/, Linux uses ~/.config/Claude/, Windows uses %APPDATA%\Claude\.
Do I need a paid Claude plan to use the MCP?
No. The Homedata MCP works with any Claude Desktop install — free, Pro or Team. The MCP server runs locally on your machine; Anthropic never sees the property data you query.
Where does the property data come from?
Homedata aggregates official UK sources — the EPC register, Environment Agency, Land Registry, ONS census, Ofsted, Home.co.uk and more — across 29 million UK properties. Every MCP tool maps to a typed endpoint on the public Homedata API.

Using another AI tool?

The Homedata MCP works with every major MCP-compatible client. Each one has its own install snippet.

Claude Code

Anthropic's terminal-native coding agent.

Install in Claude Code →

Cursor

AI-first code editor built on VS Code.

Install in Cursor →

Codex CLI

OpenAI's terminal-native coding agent.

Install in Codex CLI →

Windsurf

Codeium's agentic IDE built for flow.

Install in Windsurf →

Cline

VS Code extension by the Cline team — autonomous coding inside your editor.

Install in Cline →

Continue.dev

Open-source AI assistant for VS Code and JetBrains.

Install in Continue.dev →

Zed

High-performance, multiplayer code editor.

Install in Zed →

Or head back to the MCP hub for the full overview.

Plug 29 million UK properties into Claude Desktop

Install in under sixty seconds. Free tier, paid plans unlock sales, listings and comparables.

Get a key Read API docs View on GitHub

Latest release: homedata-mcp v0.2.0 on PyPI@if($githubStars) · ★ 0 on GitHub@endif