Skip to main content
29M UK properties, one API call. Get an API key →

Agent MCP / Codex CLI

UK property data in Codex CLI

Codex is OpenAI's coding agent and can run the local Homedata MCP while it works. Paste one message into Codex and it adds the server to its config, then answers property questions or builds against the data. For property questions in ChatGPT with nothing to install, use the hosted Homedata app.

Copy this to Codex CLI

Install the Homedata MCP server (npx -y homedata-mcp) with my API key, YOUR_API_KEY, then find 63 Harvey Lane, Norwich to check it works.

Get an API key Or set it up by hand ↓ 
~/.codex/config.toml
→ [mcp_servers.homedata]
command = "npx"
args = ["-y", "homedata-mcp"]

[mcp_servers.homedata.env]
HOMEDATA_API_KEY = "YOUR_API_KEY"

Restart Codex CLI after saving. Run /mcp inside Codex to confirm the homedata tools loaded.

Ask Codex CLI

What you can ask once it is connected

Find every address in this spreadsheet below EPC C and list what would lift it.

Draft a short report on SW11: asking prices over time, schools and crime.

Check the planning history around Cowley Road, Oxford.

60 tools in the package, from EPC and flood risk to schools, planning and prices. See everything it can check →

Setup

Connect Homedata to Codex CLI

  1. Get your API key. Get an API key with your email and copy the key from your dashboard. Top up from £20.
  2. Paste the message above into Codex CLI. It installs the server and adds it to Codex CLI's config. Prefer to do it yourself? Add the block above to ~/.codex/config.toml with your key in place of YOUR_API_KEY.
  3. Restart and ask. Restart Codex CLI after saving. Run /mcp inside Codex to confirm the homedata tools loaded.

In practice

How people use Homedata in Codex CLI

Build a property-data agent: have Codex write a script that looks up EPC and flood risk for every UPRN in a list.

Use Codex CLI to scaffold a UK property search feature against the real Homedata API without manually wiring SDKs.

Questions

Codex CLI and Homedata

How do I add an MCP server to Codex CLI?

Codex CLI's config lives at ~/.codex/config.toml. Add an [mcp_servers.homedata] block with command = "npx", args = ["-y", "homedata-mcp"] and your key in HOMEDATA_API_KEY, or paste the message on this page and let Codex add it. Restart Codex and /mcp lists homedata as connected.

Does Codex CLI support all the homedata-mcp tools?

Yes. Codex CLI implements the full MCP tool spec, so every tool the homedata server exposes (address search, EPC, flood, planning, schools and more) is available to the agent.

Can I use Homedata in ChatGPT instead?

Yes. The hosted Homedata app for ChatGPT connects to your Homedata account with nothing to install. See homedata.co.uk/chatgpt. The local MCP setup on this page remains available for Codex CLI.

Other agents

UK property data in Claude Desktop → UK property data in Claude Code → UK property data in Cursor → UK property data in Windsurf → UK property data in Cline → UK property data in Continue.dev → UK property data in Gemini CLI → UK property data in Zed →

Give Codex CLI a key.

Then ask Codex CLI about any home in England and Wales. Pay as you go from £20.

Get an API key About Agent MCP