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
• Bulk export — full data dumps for reporting, backup, or migration

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

1. Go to Settings > Connectors > Developer Mode
2. Add a new MCP connector
3. Set the command to npx -y propstack-mcp-server
4. Add environment variable PROPSTACK_API_KEY

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 (50)

Contacts (Kontakte)

| Tool | Description | |---|---| | search_contacts | Search and filter contacts by name, email, phone, status, tags, broker, GDPR status | | 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 | | get_property | Get full property details including media and custom fields | | create_property | Create a new property listing | | update_property | Update price, status, description, broker assignment | | get_property_statuses | List property statuses (Verfuegbar, Reserviert, Verkauft, etc.) |

Tasks (Aufgaben & Notizen)

| Tool | Description | |---|---| | create_task | Create a note, to-do, appointment, or cancellation (polymorphic) | | update_task | Mark done, reschedule, update notes | | get_task | Get task details with linked contacts, properties, projects |

Deals (Pipeline)

| Tool | Description | |---|---| | search_deals | Search deals by stage, pipeline, category, broker, feeling score | | create_deal | Link a contact to a property at a pipeline stage | | update_deal | Move deal through pipeline stages, update price/notes |

Search Profiles (Suchprofile)

| Tool | Description | |---|---| | list_search_profiles | List what buyers/renters are looking for | | create_search_profile | Capture buyer criteria from natural language | | update_search_profile | Adjust budget, cities, room count, features | | delete_search_profile | Remove a search profile |

Projects (Projekte)

| Tool | Description | |---|---| | list_projects | List development projects with unit counts | | get_project | Get project details with all units, media, documents |

Activities & Events (Aktivitaeten & Termine)

| Tool | Description | |---|---| | search_activities | Full activity timeline for a contact, property, or project | | list_events | Calendar events — viewings, meetings, filtered by date/state |

Emails (E-Mails)

| Tool | Description | |---|---| | send_email | Send email using a Propstack template (snippet) | | update_email | Mark read/archived, categorize, link to CRM records |

Documents (Dokumente)

| Tool | Description | |---|---| | list_documents | List files attached to a property, project, or contact | | upload_document | Upload a document (base64 data URI) |

Relationships (Beziehungen)

| Tool | Description | |---|---| | create_ownership | Link a contact as property owner (Eigentuemer) | | create_partnership | Link a contact as buyer, tenant, etc. (Kaeufer, Mieter) |

Lookups (Konfiguration)

| Tool | Description | |---|---| | list_pipelines | Get deal pipelines with stages (IDs, names, positions) | | get_pipeline | Get a single pipeline with stage details | | list_tags | List tags/groups (Merkmale) — filter contacts by group IDs | | create_tag | Create a new tag for contacts, properties, or activities | | list_activity_types | List note/todo/event templates for create_task | | list_contact_statuses | List contact statuses for search/assign | | list_reservation_reasons | List deal cancellation reasons | | list_custom_fields | Discover custom field definitions (names, types, options) | | list_users | List all brokers/agents with contact info | | list_teams | List teams/departments with member assignments | | list_locations | List geographic areas (Geolagen) for location matching |

Smart Composites (Intelligente Workflows)

| Tool | Description | |---|---| | full_contact_360 | Complete contact dossier — info, search profiles, deals, activity | | property_performance_report | Days on market, inquiry count, pipeline breakdown, activity summary | | pipeline_summary | Deals per stage, total values, stale deals needing attention | | smart_lead_intake | Full lead workflow: dedup, create/update, log notes, deal, reminder | | match_contacts_to_property | Find buyers whose search profiles match a property |

Admin (Verwaltung)

| Tool | Description | |---|---| | list_webhooks | List all configured webhook subscriptions | | create_webhook | Subscribe to CRM events (CLIENT_CREATED, PROPERTY_UPDATED, etc.) | | delete_webhook | Remove a webhook subscription | | export_data | Bulk export an entire data table as JSON | | get_contact_favorites | Get properties a contact has favorited |

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...

Development

git clone <repo-url>
cd propstack-mcp-server
npm install
npm run build    # tsc → dist/
npm start        # requires PROPSTACK_API_KEY

Project Structure

src/
  index.ts                 # Server entry point (stdio transport)
  propstack-client.ts      # HTTP client with auth, retry, error handling
  types/
    propstack.ts           # TypeScript interfaces for all API responses
  tools/
    helpers.ts             # Shared formatting utilities
    contacts.ts            # 7 contact tools
    properties.ts          # 5 property tools
    tasks.ts               # 3 task tools (polymorphic: note/todo/event/cancel)
    deals.ts               # 3 deal pipeline tools
    search-profiles.ts     # 4 search profile tools
    projects.ts            # 2 project tools
    activities.ts          # 2 activity/event tools
    emails.ts              # 2 email tools
    documents.ts           # 2 document tools
    relationships.ts       # 2 relationship tools (ownership/partnership)
    lookups.ts             # 8 lookup/config tools
    composites.ts          # 5 smart composite tools
    admin.ts               # 5 admin tools (webhooks, export, favorites)

License

MIT