ashev87/propstack-mcp

Connect AI assistants (Claude, ChatGPT) to your Propstack real estate CRM.
> **Verbinden Sie KI-Assistenten mit Ihrem Propstack-CRM** — Kontakte verwalten, Objekte durchsuchen, Deals pflegen, Besichtigungen planen und Suchprofile erstellen, alles per Sprache oder Chat.
What you can do / Was Sie damit machen koennen
- **Contact management** — search, create, update, and tag contacts with GDPR tracking
- **Property search & management** — filter by price, rooms, area, status; create and update listings
- **Deal pipeline** — create deals, move through stages, track win/loss rates
- **Buyer matching** — create search profiles from natural language ("3-Zimmer in Berlin, bis 400k, mit Balkon") and auto-match to new listings
- **Task & calendar** — log call notes, set follow-up reminders, schedule viewings
- **Email** — send templated emails linked to contacts and properties
- **360-degree contact view** — get a complete briefing before every call
- **Pipeline dashboards** — deal counts and values per stage, stale deal alerts
- **Lead intake** — one-call workflow: dedup, create contact, log notes, create deal, set reminder
> **Data protection (DSGVO):** Using this server sends personal data from your Propstack CRM into the LLM you connect (Claude, ChatGPT, …). You — the Propstack customer — remain the data controller. See Datenschutz (DSGVO) for responsibility, legal basis, the fields data-minimization parameter, and notes on automated decisions.
Quick Start
1. Set your API key
2a. Claude Desktop
Add to your Claude Desktop config (claude_desktop_config.json):
2b. Claude Code (CLI)
Add to your project's .mcp.json:
2c. ChatGPT and claude.ai (web / mobile)
These clients only connect to **remote** MCP servers over an HTTPS URL. They
cannot start a local npx command, so this server can't be added to them
directly — use Claude Desktop, Claude Code, Cursor or another local client
instead.
If you need ChatGPT or the claude.ai apps, the server has to run behind an
authenticated HTTPS endpoint. **Do not** expose it through an open tunnel or
an unauthenticated stdio-to-HTTP bridge: anyone with the URL would get full
read/write access to your CRM with your API key. Open an issue if you need a
hosted setup.
2d. Cursor IDE
1. Open **Settings** (Ctrl+,) → search "MCP"
2. Edit **MCP Servers** JSON, or add mcp.json in project root / .cursor/
**Option A — local project** (after npm run build):
Or use .env in project root — the server loads it automatically; you can omit the env block.
**Option B — npx** (published package or npx from local):
2e. Run directly
API Key / API-Schluessel
Get your Propstack API key:
1. Log in to crm.propstack.de
2. Go to **Verwaltung > API-Schluessel** (Administration > API Keys)
3. Create or copy your V1 API key
> **Hinweis:** Der API-Schluessel bestimmt die Berechtigungen. Stellen Sie sicher, dass Lese- und Schreibzugriff fuer die benoetigten Endpunkte aktiviert ist.
Available Tools (56)
Contacts (Kontakte)
| Tool | Description |
|---|---|
| search_contacts | Search and filter contacts by name, email, phone, status, tags, broker, GDPR status, custom fields |
| get_contact | Get full details of a single contact with related data |
| create_contact | Create a new contact (auto-dedup by email) |
| update_contact | Update contact details, tags, GDPR status, broker assignment |
| delete_contact | Soft-delete a contact (30-day recycle bin) |
| get_contact_sources | List lead sources (ImmoScout24, Website, Empfehlung, etc.) |
| search_contacts_by_phone | Look up a contact by phone number (formatting-insensitive) |
Properties (Objekte)
| Tool | Description |
|---|---|
| search_properties | Search properties with 11 range filters, 17 sort fields, custom-field filters |
| get_property | Get full property details including media, custom fields, energy certificate, equipment, layout, cost, and marketing fields |
| create_property | Create a new property listing, including German residential exposé fields (energy certificate, equipment, costs) |