linkedhelper-mcp 0.1.0

MCP Server for LinkedHelper 2 – read campaigns, leads and chat history from the local SQLite database

linkedhelper-mcp

MCP Server that gives Claude read-only access to your LinkedHelper 2 local database — campaigns, leads, chat history and more.

Prerequisites

• LinkedHelper 2 installed and opened at least once
• Claude Desktop

Installation (Claude Desktop)

Open Claude Desktop → Settings → Developer → Edit Config and add:

{
  "mcpServers": {
    "linkedhelper": {
      "command": "uvx",
      "args": ["linkedhelper-mcp"],
      "env": {
        "LH_DEFAULT_ACCOUNT_EMAIL": "[e-mail]"
      }
    }
  }
}

Save the file, then restart Claude Desktop. That's it — no Python install required.

LH_DEFAULT_ACCOUNT_EMAIL is optional. If you only have one LinkedHelper account, you can omit the env block entirely.

Available Tools

Tool	Description
lh_get_accounts	List all LinkedHelper accounts on this machine
lh_get_campaigns	List campaigns (active or including archived)
lh_get_campaign_detail	Campaign details: actions, total leads
lh_get_campaign_leads	Leads in a campaign, with reply filter
lh_get_chat_history	Chat threads with outbound/inbound direction
lh_get_person_detail	Full profile: email, location, company, tags, notes
lh_search_people	Search leads by name or headline
lh_get_action_results	Action execution results per campaign

Example prompts for Claude

• "Show me all active campaigns"
• "Who replied to the Outreach campaign?"
• "Give me full details for person ID 42"
• "Search for people with CTO in their headline"
• "Show my chat history with Nguyen Huan"

Configuration

Environment variables (all optional):

Variable	Description
LH_DEFAULT_ACCOUNT_EMAIL	Email of the LinkedIn account to use by default
LH_BASE_DIR	Override LinkedHelper data directory (if installed in a custom path)

LinkedHelper data is stored at:

• Linux/macOS: ~/.config/linked-helper/ / ~/Library/Application Support/linked-helper/
• Windows: %APPDATA%\linked-helper\

License

MIT