Propstack MCP

Propstack MCP Server

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

export PROPSTACK_API_KEY=your_api_key_here

2a. Claude Desktop

Add to your Claude Desktop config (claude_desktop_config.json):

{

"mcpServers": { "propstack": { "command": "npx", "args": ["-y", "propstack-mcp-server"], "env": { "PROPSTACK_API_KEY": "your_api_key_here" } } } }

2b. Claude Code (CLI)

Add to your project's .mcp.json:

{

"mcpServers": { "propstack": { "command": "npx", "args": ["-y", "propstack-mcp-server"], "env": { "PROPSTACK_API_KEY": "your_api_key_here" } } } }

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):

{

"mcpServers": { "propstack": { "command": "node", "args": ["./dist/index.js"], "cwd": "C:/Users/you/path/to/propstack_mcp", "env": { "PROPSTACK_API_KEY": "your_api_key_here" } } } }

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):

{

"mcpServers": { "propstack": { "command": "npx", "args": ["-y", "propstack-mcp-server"], "env": { "PROPSTACK_API_KEY": "your_api_key_here" } } } }

2e. Run directly

npm install propstack-mcp-server

PROPSTACK_API_KEY=your_key npx propstack-mcp-server

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)

Properties (Objekte)

Tasks (Aufgaben & Notizen)

Deals (Pipeline)

Search Profiles (Suchprofile)

Projects (Projekte)

Activities & Events (Aktivitaeten & Termine)

Emails (E-Mails)

Documents (Dokumente)

Images (Bilder)

Relationships (Beziehungen)

Lookups (Konfiguration)

Smart Composites (Intelligente Workflows)

Admin (Verwaltung)

Example Conversations / Beispiel-Konversationen

Morning Briefing / Morgen-Briefing

You: What's on my calendar today?

AI: *calls list_events with today's date range* — You have 3 viewings scheduled...

Du: Gibt es neue Leads seit gestern?

KI: *ruft search_contacts mit created_at_from=gestern auf* — 5 neue Kontakte...

Lead Intake / Leaderfassung

You: I just got off the phone with Maria Schmidt, +49 157 1234 5678. She's looking for a 3-room apartment in Berlin, budget 300-400k, must have a balcony. She found us on ImmoScout.

AI: *calls smart_lead_intake* — Contact created (ID: 4521), call note logged, follow-up reminder set for tomorrow 9:00. Would you like me to create a search profile for her criteria?

Property Matching / Objekt-Matching

Du: Wir haben ein neues Listing: 3-Zimmer-Wohnung in Charlottenburg, 385.000 EUR. Wer kommt als Kaeufer in Frage?

KI: *ruft match_contacts_to_property auf* — 12 passende Suchprofile gefunden. Top 3: Herr Weber (Score 95%), Frau Mueller (Score 88%), Herr Kim (Score 85%)...

Pipeline Review

You: How's our sales pipeline looking? Any stale deals?

AI: *calls pipeline_summary* — 47 active deals, total value 12.3M EUR. 5 deals haven't been updated in 14+ days...

Pre-Call Briefing / Vor dem Anruf

Du: Gib mir alles ueber Kontakt 3847 — ich rufe gleich an.

KI: *ruft full_contact_360 auf* — Herr Weber, Rating 3 Sterne, sucht 3-Zimmer in Berlin/Potsdam bis 400k. 2 aktive Deals, letzte Aktivitaet vor 3 Tagen...

Datenschutz (DSGVO)

English summary: Using this MCP server sends personal data from your Propstack CRM into whichever LLM you connect. You (the Propstack customer) are the data controller (Verantwortlicher) under Art. 4(7) GDPR — the tool author hosts and processes nothing. The German section below covers controller responsibility, the legal basis your LLM processing needs, the fields parameter for data minimization, automated-decision notes for match_contacts_to_property, and audit logging. These points apply to any LLM tool handling customer data; they are stated here because they are easy to overlook.

Verantwortlichkeit

Dies ist ein quelloffenes Werkzeug (Open Source). Jeder Nutzer verbindet es über seinen eigenen API-Schluessel mit seinem eigenen Propstack-Konto. Der Server ist zusta