unipile-linkedin-mcp 0.1.0

MCP server for Unipile LinkedIn API - LinkedIn search, messaging, connections, and Sales Navigator features

Unipile LinkedIn MCP Server

A fully-featured Model Context Protocol (MCP) server for the Unipile LinkedIn API. Enables AI assistants to interact with LinkedIn for search, messaging, connections, and Sales Navigator features.

Features

• LinkedIn Search - People, companies, and posts search with Classic and Sales Navigator filters
• Profile Management - View profiles, company pages, and your own profile
• Connections - Send/accept/decline invitations, list connections
• Messaging - List chats, send messages, start conversations
• InMail - Send InMail to non-connections (Premium/Sales Navigator)
• Sales Navigator - Advanced filters like tenure, seniority, company headcount

Installation

Using uvx (recommended)

uvx unipile-linkedin-mcp

Using pip

pip install unipile-linkedin-mcp

Configuration

Environment Variables

Set these environment variables before running:

export UNIPILE_API_KEY="your-api-key"
export UNIPILE_BASE_URL="https://api13.unipile.com:14376/api/v1"
export UNIPILE_ACCOUNT_ID="your-account-id"

Or create a .env file in your working directory.

Claude Desktop Configuration

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "unipile-linkedin": {
      "command": "uvx",
      "args": ["unipile-linkedin-mcp"],
      "env": {
        "UNIPILE_API_KEY": "your-api-key",
        "UNIPILE_BASE_URL": "https://api13.unipile.com:14376/api/v1",
        "UNIPILE_ACCOUNT_ID": "your-account-id"
      }
    }
  }
}

Available Tools (22 total)

Search

Tool	Description
search_people	Search people with Classic LinkedIn filters
search_people_sales_nav	Search with Sales Navigator advanced filters
search_companies	Search for companies
search_posts	Search LinkedIn posts/content
get_search_params	Get valid filter IDs (locations, industries, etc.)

Profiles

Tool	Description
list_accounts	List all connected LinkedIn accounts
get_my_profile	Get authenticated user's profile
get_profile	Get any user's full profile
get_company_profile	Get company page details

Connections

Tool	Description
send_invitation	Send connection request (max 300 char message)
list_invitations_sent	View pending outbound invites
list_invitations_received	View inbound connection requests
accept_invitation	Accept a connection request
decline_invitation	Decline a connection request
cancel_invitation	Withdraw a sent invitation
list_relations	List 1st degree connections

Messaging

Tool	Description
list_chats	List message conversations
get_chat_messages	Get messages from a chat
send_message	Send message in existing chat
start_chat	Start new conversation with connections

InMail (Premium)

Tool	Description
send_inmail	Send InMail to non-connections
get_inmail_credits	Check remaining InMail credits

Usage Examples

Search for People

# Classic LinkedIn search
search_people(keywords="software engineer", location=["103644278"], limit=10)

# Sales Navigator search with advanced filters
search_people_sales_nav(
    keywords="CTO",
    company_headcount=[{"min": 51, "max": 200}],
    changed_jobs=True,
    seniority_level=["Director", "VP"]
)

Get Search Parameter IDs

# Find location IDs
get_search_params(param_type="LOCATION", query="San Francisco")

# Find industry IDs
get_search_params(param_type="INDUSTRY", query="Software")

Send a Connection Request

send_invitation(
    provider_id="ACoAAB...",
    message="Hi! I'd love to connect."
)

Start a Conversation

# With 1st degree connection
start_chat(
    attendees_ids=["ACoAAB..."],
    text="Hello! Great connecting with you."
)

# InMail to non-connection (requires credits)
send_inmail(
    attendees_ids=["ACoAAB..."],
    subject="Quick question",
    text="Hi, I noticed your work at..."
)

Getting Unipile Credentials

1. Sign up at Unipile
2. Connect your LinkedIn account
3. Get your API key and account ID from the dashboard
4. Note your base URL (varies by region)

Rate Limits

Unipile recommends these daily limits:

• Profile views: 80-100/day (Classic), 150/day (Sales Nav)
• Invitations: 80-100/day (paid), 15/week (free)
• Messages: 100-150/day

License

MIT License - see LICENSE for details.

Contributing

Contributions welcome! Please open an issue or PR on GitHub.