You:    Scrape 30 HVAC companies in Austin TX, create a campaign called
        "HVAC Austin | Free Audit", and push the leads.

Claude: Done.
        → 28 qualified leads saved: https://docs.google.com/spreadsheets/d/...
        → Campaign created (ID: a1b2c3)
        → 28 leads uploaded. Ready to launch in Instantly.

git clone https://github.com/Sourav333444/lead-gen-mcp
cd lead-gen-mcp

python -m venv .venv
.venv\Scripts\activate        # Windows
# source .venv/bin/activate   # Mac/Linux

pip install "mcp[cli]" apify-client gspread google-auth google-auth-oauthlib requests python-dotenv

APIFY_API_TOKEN=apify_api_...
INSTANTLY_API_KEY=your_instantly_v2_key

python -c "
from google_auth_oauthlib.flow import InstalledAppFlow
flow = InstalledAppFlow.from_client_secrets_file('credentials.json', [
    'https://www.googleapis.com/auth/spreadsheets',
    'https://www.googleapis.com/auth/drive'
])
creds = flow.run_local_server(port=0)
open('token.json', 'w').write(creds.to_json())
"

{
  "mcpServers": {
    "lead-gen-toolkit": {
      "command": "/absolute/path/to/.venv/bin/python",
      "args": ["/absolute/path/to/server.py"]
    }
  }
}

{
  "mcpServers": {
    "lead-gen-toolkit": {
      "command": "C:\\path\\to\\.venv\\Scripts\\python.exe",
      "args": ["C:\\path\\to\\server.py"]
    }
  }
}

Scrape 30 roofing contractors in Denver CO and save to a sheet called "Denver Roofers"

Read the leads from [sheet URL] and push them to Instantly campaign [campaign_id]

Create an Instantly campaign called "Plumbers NYC | Free Estimate" and give me the campaign ID

server.py          # MCP server (the thing you're installing)
execution/
  gmaps_lead_pipeline.py   # Google Maps scraper + Sheet writer
.env               # Your API keys (never commit this)
credentials.json   # Google OAuth credentials (never commit this)
token.json         # Google OAuth token (never commit this)