What are the requirements for lhremote?

lhremote requires a compatible MCP client such as Claude Desktop, Claude Code, or Cursor. No additional environment variables are needed for basic setup.

Is lhremote free to use?

Yes, lhremote is open source and free to use. You can find the source code on GitHub.

What MCP clients support lhremote?

lhremote works with any MCP-compatible client including Claude Desktop (Anthropic's official desktop app), Claude Code (CLI tool), Cursor, and other editors with MCP support.

How do I configure lhremote?

Configure lhremote by adding it to your MCP client's config file. The setup block at the top of this page generates a ready-to-paste config for Claude Code, Cursor, Codex, Windsurf, and Claude Desktop.

MCP server/other

lhremote MCP Server

Q: What tools does lhremote provide?

find-app: Detect a running LinkedHelper instance. launch-app: Launch a LinkedHelper instance. list-accounts: List available LinkedIn accounts. campaign-create: Create a campaign from configuration. campaign-start: Run a specific campaign.

Q: How do I install lhremote?

Install lhremote by running: npm install -g lhremote

CLI and MCP server for LinkedHelper automation

★ 1 alexey-pelykh/lhremote ↗by alexey-pelykhupdated Mar 22, 2026

Add it to Claude Code

claude mcp add lhremote -- npx lhremote mcp

Make your agent remember this setup

lhremote's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.

npx conare@latest

Free · one command · indexes the sessions already on disk. Set up in the browser instead →

What it does

App management to detect, launch, and quit LinkedHelper instances
Account and instance control for starting and stopping LinkedIn automation
Full campaign automation including creation, configuration, and monitoring
LinkedIn profile import and cached profile search capabilities
Messaging history querying and conversation scraping

Tools 5

find-appDetect a running LinkedHelper instance

launch-appLaunch a LinkedHelper instance

list-accountsList available LinkedIn accounts

campaign-createCreate a campaign from configuration

campaign-startRun a specific campaign

Try it

→Find my running LinkedHelper instance and list all available LinkedIn accounts.

→Create a new campaign using the configuration file at ./campaign-config.yaml.

→Import the LinkedIn profile URLs from my list into the active campaign.

→Start the campaign with ID 123 and monitor its progress.

→Check for new replies in my LinkedIn conversations.

Original README from alexey-pelykh/lhremote

lhremote: LinkedHelper Automation Toolkit

CLI and MCP server for LinkedHelper automation.

This project is brought to you by Alexey Pelykh.

What It Does

lhremote lets AI assistants (Claude, etc.) control LinkedHelper through the Model Context Protocol. It can:

App management — detect, launch, and quit LinkedHelper instances
Account & instance control — list accounts, start/stop instances, check status
Campaign automation — create, configure, start, stop, and monitor campaigns with full action-chain management
People import — import LinkedIn profile URLs into campaign target lists
Profile queries — look up and search cached LinkedIn profiles from the local database
Messaging — query messaging history, check for new replies, scrape conversations from LinkedIn
Action discovery — list available LinkedHelper action types with configuration schemas

New to lhremote? Check out the Getting Started guide for a step-by-step walkthrough.

Prerequisites

Node.js >= 24
LinkedHelper desktop application (requires a paid subscription)

Installation

npm install -g lhremote

Or run directly with npx:

npx lhremote --help

Usage with Claude Desktop

Add to your Claude Desktop configuration (claude_desktop_config.json):

{
    "mcpServers": {
        "lhremote": {
            "command": "npx",
            "args": ["lhremote", "mcp"]
        }
    }
}

Once configured, Claude can use all 44 tools directly. A typical workflow:

find-app — Detect a running LinkedHelper instance (or launch-app to start one)
list-accounts — See available LinkedIn accounts
start-instance — Start an instance for an account
describe-actions — Explore available action types
campaign-create — Create a campaign from YAML/JSON configuration
import-people-from-urls — Import target LinkedIn profiles into the campaign
campaign-start — Run the campaign
campaign-status / campaign-statistics — Monitor progress
query-messages / check-replies — Review messaging results

CLI Usage

The lhremote command provides the same functionality as the MCP server. Every MCP tool has a corresponding CLI command.

App Management

lhremote find-app [--json]
lhremote launch-app [--cdp-port ] [--force]
lhremote quit-app [--cdp-port ]

Account & Instance

lhremote list-accounts [--cdp-port ] [--json]
lhremote start-instance <accountId> [--cdp-port ]
lhremote stop-instance <accountId> [--cdp-port ]
lhremote check-status [--cdp-port ] [--json]

Campaigns

lhremote campaign-list [--include-archived] [--json]
lhremote campaign-create --file  | --yaml <config> | --json-input <config> [--cdp-port ] [--json]
lhremote campaign-get <campaignId> [--cdp-port ] [--json]
lhremote campaign-export <campaignId> [--format yaml|json] [--output ] [--cdp-port ]
lhremote campaign-update <campaignId> [--name <name>] [--description <text>] [--clear-description] [--cdp-port ] [--json]
lhremote campaign-delete <campaignId> [--cdp-port ] [--json]
lhremote campaign-start <campaignId> --person-ids <ids> | --person-ids-file  [--cdp-port ] [--json]
lhremote campaign-stop <campaignId> [--cdp-port ] [--json]
lhremote campaign-status <campaignId> [--include-results] [--limit <n>] [--cdp-port ] [--json]
lhremote campaign-statistics <campaignId> [--action-id <id>] [--max-errors <n>] [--cdp-port ] [--json]
lhremote campaign-retry <campaignId> --person-ids <ids> | --person-ids-file  [--cdp-port ] [--json]
lhremote campaign-list-people <campaignId> [--action-id <id>] [--status <status>] [--limit <n>] [--offset <n>] [--cdp-port ] [--json]

Campaign Actions

lhremote campaign-add-action <campaignId> --name <name> --action-type <type> [--description <text>] [--cool-down <ms>] [--max-results <n>] [--action-settings <json>] [--cdp-port ] [--json]
lhremote campaign-remove-action <campaignId> <actionId>

Frequently Asked Questions

What are the key features of lhremote?

App management to detect, launch, and quit LinkedHelper instances. Account and instance control for starting and stopping LinkedIn automation. Full campaign automation including creation, configuration, and monitoring. LinkedIn profile import and cached profile search capabilities. Messaging history querying and conversation scraping.

What can I use lhremote for?

Automating LinkedIn outreach campaigns by importing target profile lists. Monitoring campaign performance and statistics directly through AI chat. Managing multiple LinkedIn accounts by programmatically switching instances. Scraping and reviewing LinkedIn conversation history for lead qualification.

How do I install lhremote?

Install lhremote by running: npm install -g lhremote

What MCP clients work with lhremote?

lhremote works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Conare · memory for coding agents

Turn this server into reusable context

Keep lhremote docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Set up free$npx conare@latest