Add it to Claude Code
claude mcp add -e "PROPSTACK_API_KEY=${PROPSTACK_API_KEY}" propstack-mcp -- npx -y propstack-mcp-serverPROPSTACK_API_KEYMake your agent remember this setup
propstack-mcp's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Full contact management including search, creation, and GDPR tracking.
- Advanced property search with price, room, and area filtering.
- Deal pipeline management to track stages and win/loss rates.
- Buyer matching by creating search profiles from natural language.
- Task and calendar integration for notes, reminders, and viewings.
Tools 6
search_contactsSearch and filter contacts by name, email, phone, status, tags, broker, or GDPR status.get_contactGet full details of a single contact with related data.create_contactCreate a new contact with auto-deduplication by email.search_propertiesSearch properties with range filters and sort fields.create_taskCreate a note, to-do, appointment, or cancellation.search_dealsSearch deals by stage, pipeline, category, broker, or feeling score.Environment Variables
PROPSTACK_API_KEYrequiredYour V1 API key from Propstack CRM administration settings.Try it
Original README from ashev87/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
- 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
- Go to Settings > Connectors > Developer Mode
- Add a new MCP connector
- Set the command to
npx -y propstack-mcp-server - Add environment variable
PROPSTACK_API_KEY
2d. Cursor IDE
- Open Settings (Ctrl+,) → search "MCP"
- Edit MCP Servers JSON, or add
mcp.jsonin 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:
- Log in to crm.propstack.de
- Go to Verwaltung > API-Schluessel (Administration > API Keys)
- 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 pipeli |