Skip to main content
Glama
aadarshlodhi

Lead Details MCP

by aadarshlodhi

Lead Details MCP

A Lead Generation MCP Server for Claude Desktop that lets you manage leads and send emails directly from Claude chat.

🛠️ Tools Available

Tool

Description

add_lead

Add a new lead (name, email, phone, company, source, status)

list_all_leads

List every lead in the database

search_lead_by_name

Search leads by name (partial match)

get_leads_by_date

Filter leads by date range

get_leads_by_status

Filter by status (New / Contacted / Qualified / Closed)

update_lead_status

Update a lead's status by ID

get_lead_summary

Summary of all leads by status and source

send_email_to_lead

Send email to a lead using their stored email

send_custom_email

Send email to any address

Related MCP server: Revenue Engine MCP

🚀 Setup

1. Install dependencies

pip install fastmcp python-dotenv

2. Configure email

Create a .env file in the project root:

EMAIL_ADDRESS=your@gmail.com
EMAIL_PASSWORD=your_16_char_app_password
SMTP_HOST=smtp.gmail.com
SMTP_PORT=587

For Gmail: Generate an App Password at myaccount.google.com/apppasswords

3. Add to Claude Desktop config

Edit claude_desktop_config.json:

{
  "mcpServers": {
    "lead-details": {
      "command": "C:\\Path\\To\\python.exe",
      "args": ["path\\to\\main.py"]
    }
  }
}

4. Restart Claude Desktop

The lead-details server will appear in Claude's Connectors panel.

💬 Example Claude Prompts

  • "Add lead: John Doe, john@acme.com, Acme Corp, from LinkedIn"

  • "Show me all leads"

  • "Search for leads named John"

  • "List all Qualified leads"

  • "Send email to lead #1 subject Hello body Nice to meet you"

📋 Requirements

  • Python 3.10+

  • fastmcp

  • python-dotenv

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    A
    maintenance
    Enables Claude to interact with email accounts via IMAP and SMTP, providing tools for searching, reading, sending, and managing emails across multiple providers.
    40
    500 npm
    96
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables Claude to manage GoHighLevel CRM contacts, pipelines, and workflows through natural language commands.
    34 npm
    MIT