Skip to main content
Glama
southleft

LinkedIn Intelligence MCP Server

by southleft
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

LinkedIn Content Intelligence Platform

Your AI-powered content strategist for LinkedIn.

Create compelling content, analyze what resonates with your audience, research industry trends, and build meaningful professional relationships—all through natural conversation with Claude.

A Content-First Approach to LinkedIn

This isn't another automation tool for mass outreach. It's a Content Intelligence Platform designed for professionals who value quality over quantity.

What makes this different:

  • Content Strategy Focus: Understand what content performs, why it resonates, and how to improve

  • Authentic Engagement: Build genuine professional relationships, not spray-and-pray automation

  • Research-Driven: Make informed decisions based on real data about your audience and industry

  • Quality Over Quantity: Craft thoughtful content rather than churning out generic posts

The Power of AI-Assisted Workflows

Imagine this: You ask Claude to research a competitor's content strategy. Minutes later, you understand their top-performing topics, posting patterns, and engagement drivers. You craft a differentiated response post, Claude helps optimize it for your audience, and you schedule it for when your network is most active.

Cross-platform intelligence:

LinkedIn Research → Blog Post → WordPress Publish → LinkedIn Promotion

  1. Analyze trending topics from industry thought leaders

  2. Develop a unique perspective with Claude's help

  3. Publish to your blog (via another MCP)

  4. Share insights with your LinkedIn network

This is content intelligence—understanding your professional landscape and creating content that genuinely adds value.

Who Is This For?

Content Creators & Thought Leaders

  • Develop and refine your content strategy with data-driven insights

  • Understand what topics resonate with your audience

  • Build a consistent publishing cadence with draft management and scheduling

  • Analyze engagement patterns to continuously improve

Marketing & Brand Teams

  • Research competitor content strategies and positioning

  • Track industry trends and thought leadership topics

  • Measure content performance and engagement metrics

  • Coordinate team content calendars

Professionals Building Their Brand

  • Craft authentic content that showcases expertise

  • Engage meaningfully with your professional network

  • Research industry conversations before contributing

  • Build genuine connections with relevant professionals

Analysts & Researchers

  • Gather company and professional data for market research

  • Analyze engagement patterns and content trends

  • Generate comprehensive reports on LinkedIn presence

  • Track industry movements and competitive intelligence

Features

Content Creation

Feature

Description

Text Posts

Create and publish professional posts with AI assistance

Image Posts

Share images with captions and hashtags

Polls

Create interactive polls to engage your audience

Comments

Comment on posts (images supported in nested replies only)

Rich Formatting

AI-optimized content with hooks, CTAs, and hashtags

Content Planning

Feature

Description

Draft Management

Save, edit, and organize drafts with tags

Post Scheduling

Schedule posts for optimal engagement times

Content Calendar

View and manage your scheduled content

Content Analysis

Get AI suggestions to improve engagement

Profile Research

Feature

Description

Profile Viewing

View detailed LinkedIn profiles

Profile Enrichment

Get comprehensive profile data with multi-source fallback

Profile Interests

Discover who/what a person follows (influencers, companies, topics)

Similar Profiles

Find profiles similar to a given person

Profile Articles

Get articles written by any profile

Skills & Endorsements

View skills and endorsement data

Company Research

Feature

Description

Company Search

Search for companies by keywords

Company Details

Get company info, employee counts, and descriptions

Company by Domain

Look up companies by website domain

Organization Insights

Follower counts and engagement data

Analytics & Engagement

Feature

Description

Post Analytics

Reactions, comments, and engagement metrics (via official API)

Content Performance

Analyze what content works best

Optimal Posting Times

Derived insights from your engagement patterns

Hashtag Analysis

Derived insights from your post performance

Engagement Reports

Comprehensive performance reports

Profile Views

Track who's viewing your profile

Messaging & Conversations

Feature

Description

View Conversations

Browse your LinkedIn message threads

Read Messages

Access conversation history with connections

Send Messages

Message your connections directly

Conversation Management

Mark conversations as read

Note: Messaging features are designed for maintaining existing professional relationships. LinkedIn's terms of service prohibit automated mass messaging.

Connections & Networking

Feature

Description

View Invitations

See pending connection requests

Send Requests

Connect with professionals (with optional message)

Manage Invitations

Accept or decline connection requests

Connection Management

Manage your professional network

Best Practice: Connection requests should be personalized and relevant. Sending mass requests violates LinkedIn's terms and damages your professional reputation.

Job Intelligence

Feature

Description

Job Search

Search postings with filters (keywords, location, remote, experience)

Job Details

Get comprehensive job posting information

Skills Analysis

See required skills for positions

Quick Start

Prerequisites

  • Python 3.11+

  • uv (recommended) or pip

  • LinkedIn account

  • LinkedIn Developer App (free, 5-minute setup)

Installation

git clone https://github.com/southleft/linkedin-mcp.git cd linkedin-mcp # Install with uv (recommended) uv venv && source .venv/bin/activate uv pip install -e . # Install browser automation (optional, for enhanced features) playwright install chromium

LinkedIn Developer Setup

  1. Go to LinkedIn Developer Portal

  2. Click "Create app"

  3. Fill in details:

    • App name: e.g., "My LinkedIn MCP"

    • LinkedIn Page: Select or create a company page

    • Privacy policy URL: Your website or LinkedIn profile

  4. Go to Products → Request "Share on LinkedIn" (instant approval)

  5. Go to Auth tab:

    • Copy Client ID and Client Secret

    • Add redirect URL: http://localhost:8765/callback

Configuration

Create a .env file in the project root:

# LinkedIn OAuth (Required for posting) LINKEDIN_CLIENT_ID=your_client_id LINKEDIN_CLIENT_SECRET=your_client_secret LINKEDIN_API_ENABLED=true # Enhanced Data API (Recommended for reliable profile/company lookups) # Powers the top 2 fallback sources: Professional Network Data API + Fresh LinkedIn Data API THIRDPARTY_RAPIDAPI_KEY=your_api_key

Note: The RapidAPI key enables the most reliable data sources in the fallback chain. Without it, the server falls back to cookie-based methods which are prone to LinkedIn's bot detection.

Authentication

# Authenticate with LinkedIn (opens browser) linkedin-mcp-auth oauth # Optional: Extract cookies for additional features linkedin-mcp-auth extract-cookies --browser chrome # Verify setup linkedin-mcp-auth status

Connect to Claude Desktop

Add the following to your Claude Desktop config file:

Platform

Config Location

macOS

~/Library/Application Support/Claude/claude_desktop_config.json

Windows

%APPDATA%\Claude\claude_desktop_config.json

Linux

~/.config/Claude/claude_desktop_config.json

Complete configuration example:

{ "mcpServers": { "linkedin": { "command": "/path/to/linkedin-mcp/.venv/bin/python", "args": ["-m", "linkedin_mcp.main"], "cwd": "/path/to/linkedin-mcp", "env": { "LINKEDIN_CLIENT_ID": "your_client_id", "LINKEDIN_CLIENT_SECRET": "your_client_secret", "LINKEDIN_API_ENABLED": "true", "THIRDPARTY_RAPIDAPI_KEY": "your_api_key", "PYTHONPATH": "/path/to/linkedin-mcp/src", "LOG_LEVEL": "INFO" } } } }

Critical: Claude Desktop does not read .env files—all environment variables must be explicitly passed in the config.

After updating the config:

  1. Quit Claude Desktop completely

  2. Reopen Claude Desktop

  3. The LinkedIn MCP server will connect automatically

Connect to Claude Code

Add to ~/.claude.json:

{ "mcpServers": { "linkedin-mcp": { "type": "stdio", "command": "/path/to/linkedin-mcp/.venv/bin/python", "args": ["-m", "linkedin_mcp.main"], "cwd": "/path/to/linkedin-mcp", "env": { "LINKEDIN_CLIENT_ID": "your_client_id", "LINKEDIN_CLIENT_SECRET": "your_client_secret", "LINKEDIN_API_ENABLED": "true", "THIRDPARTY_RAPIDAPI_KEY": "your_api_key", "PYTHONPATH": "/path/to/linkedin-mcp/src" } } } }

Run /mcp in Claude Code to connect.

Usage Examples

Content Creator Workflow

You: "Create a LinkedIn post about the importance of continuous learning in tech" Claude: Here's a draft optimized for engagement: "In tech, the moment you stop learning is the moment you start falling behind. Every new framework, language, or methodology is an opportunity to expand your toolkit and thinking. The best engineers I know aren't just skilled—they're perpetually curious. What are you learning this week? #ContinuousLearning #TechCareers #GrowthMindset" Should I post this now, schedule it, or save as a draft?

Content Planning

You: "Save this as a draft for my product launch and schedule it for Tuesday 9am" Claude: Done! I've: 1. Saved your draft titled "Product Launch" 2. Scheduled it for Tuesday, 9:00 AM (your timezone) You can view your drafts anytime or adjust the schedule.

Profile Research

You: "Look up the CEO of Microsoft on LinkedIn" Claude: Found Satya Nadella's profile: - Chairman and CEO at Microsoft - Focus on cloud computing and AI transformation - Author and thought leader in technology Would you like me to find similar profiles or see their recent articles?

Company Research

You: "Look up information about anthropic.com" Claude: Found Anthropic: - AI safety company - Headquarters in San Francisco - Focus on AI research and safety Would you like more details or to search for employees?

Available Tools

See

Content Creation

Tool

Description

create_post(text, visibility)

Publish a text post

create_image_post(text, image_path, alt_text)

Post with an image

create_poll(question, options, duration_days)

Create an interactive poll

create_comment(post_urn, text)

Comment on a post

delete_post(post_urn)

Remove a published post

Draft Management

Tool

Description

create_draft(content, title, tags)

Save content for later

list_drafts(tag)

View all saved drafts

get_draft(draft_id)

Get a specific draft

update_draft(draft_id, content, title, tags)

Edit a draft

delete_draft(draft_id)

Remove a draft

publish_draft(draft_id, visibility)

Publish a saved draft

analyze_draft_content(content, industry)

Get AI suggestions

Scheduling

Tool

Description

schedule_post(content, scheduled_time, timezone)

Schedule for future

list_scheduled_posts(status)

View scheduled posts

get_scheduled_post(job_id)

Get schedule details

update_scheduled_post(job_id, content, time)

Modify scheduled post

cancel_scheduled_post(job_id)

Cancel a scheduled post

Profile Research

Tool

Description

get_my_profile()

Get your LinkedIn profile

get_profile(profile_id)

View any LinkedIn profile

get_profile_contact_info(profile_id)

Get contact details

get_profile_skills(profile_id)

Get skills and endorsements

get_profile_interests(profile_id)

Get interests (influencers, companies, topics)

get_similar_profiles(profile_id, limit)

Find similar profiles

get_profile_articles(profile_id, limit)

Get articles written by profile

get_auth_status()

Check authentication status

get_rate_limit_status()

Monitor API usage

Company Research

Tool

Description

search_people(keywords, limit, keyword_title)

Find professionals

search_companies(keywords, limit)

Search for companies

get_company(public_id)

Get company details

get_company_by_domain(domain)

Look up company by website domain

get_article(article_url)

Get full article content

get_organization_followers(organization_id)

Get follower count

Analytics

Tool

Description

get_feed(limit)

Get your LinkedIn feed

get_profile_posts(profile_id, limit)

Get posts from a profile

get_profile_views()

Get your profile view statistics

get_post_reactions(post_urn)

Get reactions on a post

get_post_comments(post_urn)

Get comments on a post

analyze_engagement(post_urn)

Deep engagement analysis

analyze_content_performance(profile_id)

Content patterns

analyze_optimal_posting_times(profile_id)

Best times to post

analyze_hashtag_performance(profile_id)

Hashtag effectiveness

generate_engagement_report(profile_id)

Full engagement report

Messaging

Tool

Description

get_conversations(limit)

List all message conversations

get_conversation(conversation_urn)

Get messages from a conversation

get_conversation_details(profile_urn)

Get conversation ID for a profile

send_message(conversation_urn, text)

Send a message to a conversation

mark_conversation_as_seen(conversation_urn)

Mark conversation as read

Connections

Tool

Description

get_invitations(limit)

Get pending connection requests

send_connection_request(profile_id, message)

Send a connection request

reply_invitation(invitation_urn, action)

Accept or reject an invitation

remove_connection(profile_id)

Remove a connection

Job Search

Tool

Description

search_jobs(keywords, location, remote, ...)

Search job postings

get_job(job_id)

Get detailed job information

get_job_skills(job_id)

Get required skills for a job

CLI Commands

# Authentication linkedin-mcp-auth status # Check auth status linkedin-mcp-auth oauth # Authenticate via OAuth linkedin-mcp-auth oauth --force # Force re-authentication linkedin-mcp-auth extract-cookies # Extract session cookies linkedin-mcp-auth logout --all # Clear all credentials # Server linkedin-mcp # Start MCP server python -m linkedin_mcp # Alternative server start

Configuration Reference

Variable

Default

Description

LINKEDIN_CLIENT_ID

-

OAuth Client ID (required for posting)

LINKEDIN_CLIENT_SECRET

-

OAuth Client Secret (required for posting)

LINKEDIN_API_ENABLED

false

Enable API features

THIRDPARTY_RAPIDAPI_KEY

-

API key for enhanced profile data

MCP_TRANSPORT

stdio

Transport: stdio, streamable-http

MCP_HOST

127.0.0.1

HTTP server host

MCP_PORT

8000

HTTP server port

LOG_LEVEL

INFO

Logging level

Limitations

Feature

Status

Notes

Text/Image/Poll Posts

Supported

Via Official LinkedIn API

Article Link Shares

Supported

External URLs with metadata

Comments

Supported

Requires Community Management API approval

Direct Messages

Supported

Via unofficial API (requires cookies)

Connection Requests

Supported

Via unofficial API (requires cookies)

Job Search

Supported

Via unofficial API (requires cookies)

Native LinkedIn Articles

Not Available

LinkedIn API limitation

Newsletters

Not Available

No API access

Note: Features marked "requires cookies" use LinkedIn's unofficial API. These work reliably but may require periodic cookie refresh (every 24-48 hours). Run linkedin-mcp-auth extract-cookies to refresh.

Troubleshooting

"Profile lookup returns error"

Ensure THIRDPARTY_RAPIDAPI_KEY is set in your Claude Desktop config:

"env": { "THIRDPARTY_RAPIDAPI_KEY": "your_api_key", ... }

Important: Claude Desktop does not read .env files. You must add the key directly to the config's env section.

"LinkedIn client not initialized"

linkedin-mcp-auth status # Check configuration linkedin-mcp-auth oauth # Re-authenticate

"Application context not initialized"

Reconnect the MCP server:

  • Claude Desktop: Quit and reopen the app

  • Claude Code: Run /mcp to reconnect

Posts not appearing

  • Verify OAuth: linkedin-mcp-auth status

  • Ensure "Share on LinkedIn" product is enabled in Developer Portal

Comments failing with permission error

  • Comments require the "Community Management API" product

  • Apply for access in your LinkedIn Developer Portal

Search returns empty results

  • Search relies on session cookies which expire after ~24 hours

  • Refresh cookies: linkedin-mcp-auth extract-cookies --browser chrome

  • Note: Profile and company lookups use the RapidAPI fallback and are unaffected

Security

  • OAuth tokens: Stored securely in system keychain

  • Session cookies: Encrypted local storage

  • Credentials: Environment variables only

  • No data collection: Everything runs locally

Development

# Install dev dependencies uv pip install -e ".[dev]" # Run tests pytest tests/ -v # Linting ruff check src/ && ruff format src/ # Type checking mypy src/linkedin_mcp

Architecture

Intelligent API Fallback

Under the hood, the server uses a multi-source architecture that automatically falls back through APIs ordered by reliability:

Priority

Source

Reliability

1

Professional Network Data API

Highest - 55 endpoints

2

Fresh LinkedIn Data API

High - profiles & search

3

Marketing API

High - organizations (official)

4

Enhanced HTTP Client

Medium - anti-detection

5

Headless Browser

Medium - slowest but reliable

6

Unofficial API

Lowest - cookie-based, prone to blocking

This ensures high availability, automatic recovery from failures, and best-effort data retrieval.

License

MIT License - see LICENSE for details.

Acknowledgments

Built for professionals who value authentic engagement over automation.

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

Resources

Tools

View all tools

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/southleft/linkedin-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server