io.github.chrischallPublished by GitHub account chrischallv1.2.0Updated Nov 7, 2026
Hemnet.se real estate for Claude: search, sold prices, listings & market stats
Searches hemnet.se, Sweden's largest real-estate portal, letting an assistant find for-sale and sold listings, pull details and photos, compute market stats…
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Follow the launch instructions in the repository.
An MCP server for hemnet.se, Sweden's largest real-estate portal. Search for-sale listings, look up sold prices (slutpriser), pull full listing detail and photos, compute market statistics, resolve addresses, and run a Swedish mortgage calculation — all from Claude.
⚠️ This project is built and maintained by AI (Claude). It reads hemnet.se through its public GraphQL API. Use at your own discretion and within hemnet.se's terms of service.
npx hemnet-mcp just works (a browser extension is
only needed if Hemnet serves a Cloudflare challenge — see below).bostadsrätt
fees (avgift), energy class, and a mortgage model that follows Swedish
rules (amorteringskrav, ränteavdrag).Hemnet sometimes fronts its GraphQL API with a Cloudflare bot challenge.
When that happens the server switches (under the default
HEMNET_TRANSPORT=auto) to a browser bridge that sends the same anonymous
queries from a www.hemnet.se tab in your own browser — no Hemnet login
needed. That needs the ContextMint Bridge extension, installed from
its releases:
in Chrome, unzip the chrome zip and load it unpacked, then approve the
pairing prompt the first time. Safari isn't available yet (it will ship
inside the ContextMint app, which has no public download), so use Chrome
for now.
ContextMint Bridge is the fetchproxy browser extension under its new name,
from the same maintainer — fetchproxy's own README
(https://github.com/chrischall/fetchproxy#extension) points to it. Its source
is public at https://github.com/nullnet-app/contextmint-bridge: build it
yourself, or check a release zip against the .sha256 file published beside
it (shasum -a 256 -c contextmint-bridge-chrome-<version>.zip.sha256).
Or pass a free-text location to any search tool and it resolves the top
hit for you.
All output records use numbers: price / final_price /
fee_monthly in SEK, living_area_sqm / land_area_sqm in m², rooms
as a number. A derived price_per_sqm is always included when price and
living area allow it (even when Hemnet omits it, common on houses). The
original Hemnet-formatted strings are kept alongside as *_formatted.
hemnet-mcp is also importable, so it can serve as a Hemnet portal source inside a larger project (e.g. a cross-portal realty orchestrator):
The library entry (import … from 'hemnet-mcp') re-exports the client,
the normalised record types, the pure derivations
(computeMarketStats, calculateSwedishMortgage, money/url helpers),
and every tool registrar (registerHemnetTools(server, client) to graft
the tools onto your own MCP server).
Tests drive every tool and the client through an in-memory fake
transport — no live hemnet.se calls. See CLAUDE.md for architecture,
the GraphQL quirks, and contribution conventions.
MIT
Source: README.md at commit 1c70117
Resolve a place name to Hemnet location ids
Look up Hemnet location ids for a free-text place name (municipality, district, or area). Returns ranked hits with `location_id`, `full_name`, and `parent_full_name`. Feed a `location_id` into hemnet_search_listings / hemnet_search_sold. Read-only.
limitqueryrequiredSearch Hemnet for-sale listings
Search active for-sale property listings on hemnet.se by location and optional filters (price band in SEK, rooms, living area in m², property-type groups, keywords). Returns listing summaries with price, fee, m², rooms, price-per-m², and coordinates. Provide `location_ids` (from hemnet_autocomplete_location) or a free-text `location`. Read-only.
sortlimitoffsetkeywordslocationprice_maxprice_minrooms_maxrooms_minlocation_idsliving_area_maxliving_area_min+1 moreGet a Hemnet for-sale listing by id or URL
Fetch the full detail of a single active for-sale listing by its Hemnet id or a /bostad/ URL. Returns price, monthly fee, yearly running costs, living/land area in m², rooms, tenure, construction year, energy class, broker, description, status labels, coordinates, and gallery photo URLs. For a SOLD listing use hemnet_get_sold_listing instead. Read-only.
idrequiredphoto_limitGet photo URLs for a Hemnet listing
Return the gallery photo URLs for an active for-sale Hemnet listing by id or /bostad/ URL. Read-only.
idrequiredlimitSearch Hemnet sold listings (slutpriser)
Search SOLD property listings ("slutpriser") on hemnet.se by location and optional filters. Each result carries the achieved final price, the asking price, and the over/under-asking percentage — the core comps signal for valuation. Provide `location_ids` (from hemnet_autocomplete_location) or a free-text `location`. Read-only.
sortlimitoffsetkeywordslocationprice_maxprice_minrooms_maxrooms_minlocation_idsliving_area_maxliving_area_min+1 moreGet a Hemnet sold listing by id or URL
Fetch the full detail of a single SOLD listing by its Hemnet id or a /salda/ URL. Returns final price, asking price, price change, m², rooms, tenure, broker, and coordinates. Read-only.
idrequiredCompare several Hemnet listings
Fetch and normalise multiple active for-sale Hemnet listings at once (by id or /bostad/ URL) for side-by-side comparison. Up to 20 targets; input order preserved; per-row errors captured. Read-only.
idsrequiredResolve a street address to a Hemnet listing
Resolve a free-text Swedish street address to a live Hemnet for-sale listing. Give the `address` (street + number) and a `location` (city/area/municipality). Returns the matched listing with a `matched: true`, the match `score`, and `matched_via`, or `{ resolved: false }` when nothing matches. Scans up to 500 listings in the location; a miss with `truncated: true` is not definitive — pass price_min/price_max or a smaller location to narrow it. Read-only.
addressrequiredlocationrequiredprice_maxprice_minHemnet sold-price market statistics
Aggregate median/average statistics from recent SOLD listings for a location (and optional property-type/size filters): median & average final price, median & average price-per-m², and average over/under-asking percentage. The stats cover the most recent `max_sales` sales (default 200, max 500), not necessarily every match — compare `sampled_sales` with `total_matching_sales`. Provide `location_ids` or a free-text `location`. Read-only.
sortlimitoffsetkeywordslocationmax_salesprice_maxprice_minrooms_maxrooms_minlocation_idsliving_area_max+2 moreCalculate a Swedish monthly mortgage cost
Local-only Swedish mortgage calculator (all amounts SEK). Returns the monthly cost broken into interest, mandated amortisation (amorteringskrav from LTV, rules as of 1 April 2026), BRF fee (avgift), and operating cost — with both gross and after-tax (ränteavdrag) totals. Provide `down_payment` OR `down_payment_percent` (defaults to the legal 10% minimum). No network call.
pricerequiredmonthly_feedown_paymentinterest_raterequiredamortization_rategross_yearly_incomedown_payment_percentmonthly_operating_costVerify the ContextMint Bridge connection end-to-end
Round-trips a small public www.hemnet.se URL (/graphql) through ContextMint Bridge (your signed-in browser tab) and returns diagnostics: the bridge's role (host/peer/null), port, version, the extension link (linked / pair pending / not attached / never answered), the elapsed round-trip time, and a plain-English hint distinguishing 'bridge never came up' from 'extension not connected' from 'this browser can't serve a capability' from 'real www.hemnet.se-side problem'. Read-only, no auth required. Call this when a real tool fails and you want to know which hop broke.
Takes no parameters.
90% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
{ "mcpServers": { "hemnet": { "command": "npx", "args": ["-y", "hemnet-mcp"] } }}git clone https://github.com/chrischall/hemnet-mcpcd hemnet-mcpnpm installnpm run buildnode dist/index.js1. hemnet_autocomplete_location { query: "Vasastan" } → location_id 9259702. hemnet_search_listings { location_ids: ["925970"], rooms_min: 2, price_max: 6000000 } → listing summaries3. hemnet_get_market_stats { location_ids: ["925970"], housing_form_groups: ["APARTMENTS"] } → median final price, price-per-m²4. hemnet_calculate_mortgage { price: 4695000, interest_rate: 3.9, monthly_fee: 2800 } → monthly cost, gross and after-taximport { createHemnetClient, computeMarketStats } from 'hemnet-mcp';
const hemnet = createHemnetClient();const { cards } = await hemnet.searchSales({ locationIds: ['925970'] }, { limit: 50 });const stats = computeMarketStats(cards.map(formatSaleCard));npm test # vitest (mocked transport, no network)npm run test:coverage # 100% coverage enforced on src/**npm run typechecknpm run build