@betterknocks/mcp

MCP server for BetterKnocks — door-to-door sales CRM.

Connect Cursor, Claude Desktop, or any MCP client to manage leads, log knocks, track activities, and view analytics.

Install

npm install -g @betterknocks/mcp

Configuration

Set these environment variables:

| Variable | Description | |----------|-------------| | BETTERKNOCKS_API_URL | API base URL (default: http://localhost:3001) | | BETTERKNOCKS_API_KEY | Your Pro API key (bk_live_...) |

Cursor Setup

{
  "mcpServers": {
    "betterknocks": {
      "command": "npx",
      "args": ["-y", "@betterknocks/mcp"],
      "env": {
        "BETTERKNOCKS_API_URL": "https://api.betterknocks.com",
        "BETTERKNOCKS_API_KEY": "bk_live_your_key_here"
      }
    }
  }
}

Claude Desktop Setup

{
  "mcpServers": {
    "betterknocks": {
      "command": "npx",
      "args": ["-y", "@betterknocks/mcp"],
      "env": {
        "BETTERKNOCKS_API_URL": "https://api.betterknocks.com",
        "BETTERKNOCKS_API_KEY": "bk_live_your_key_here"
      }
    }
  }
}

Getting an API Key

1. Upgrade to BetterKnocks Pro
2. Create a key via the API:

curl -X POST https://api.betterknocks.com/v1/api-keys \
  -H "Authorization: Bearer <firebase-id-token>" \
  -H "Content-Type: application/json" \
  -d '{"name": "Cursor MCP"}'

Store the returned bk_live_... key securely — it is only shown once.

Available Tools

• Workspaces: list_workspaces, get_workspace
• Leads: list_leads, get_lead, create_lead, update_lead, update_lead_status
• Activities: list_activities, log_knock, log_activity
• Products: list_products, create_product
• Schedule: list_events, create_event
• Analytics: get_analytics

License

Proprietary — requires BetterKnocks Pro subscription.