What can you do with this server?

The LinkedIn Intelligence MCP Server is an AI-powered platform that helps professionals manage their LinkedIn presence through natural conversation with Claude. It provides comprehensive tools for content creation, research, analytics, and networking. Content Creation & Management: Create and publish text, image, video, document, and poll posts using LinkedIn's Official API. Edit and delete posts, add comments (with image support in nested replies), and manage reactions. Organize content with draft management, tagging, and scheduling for optimal posting times. Profile Research & Intelligence: Get comprehensive profile data with multi-source enrichment including skills, endorsements, interests, and articles. Find similar profiles, perform batch lookups (up to 10 profiles), and update your headline, summary, photos, and skills. Calculate profile completeness scores with improvement suggestions. Company & Organization Research: Search companies by keywords or domain, retrieve detailed information including employee counts and descriptions, access company updates and follower counts, and get educational institution data. Analytics & Insights: Analyze engagement patterns and content performance, track reactions, comments, and shares, determine optimal posting times, evaluate hashtag effectiveness, understand audience demographics, and generate comprehensive engagement reports. Messaging & Networking: View and manage message conversations, send direct messages to connections, send and manage connection requests, and accept or decline invitations. Job Intelligence: Search job postings with filters for keywords, location, remote work, and experience level. Get detailed job information and analyze required skills. Advertising Research: Search LinkedIn's Ad Library by keyword or advertiser to access ad content, targeting, and impression data. Technical Features: OAuth 2.0 and cookie-based authentication, multi-source API architecture with intelligent fallback across 6+ data sources, rate limiting monitoring, caching for performance optimization, debug tools, and local execution with secure credential storage. Integrates with Claude Desktop and Claude Code via Model Context Protocol.

Which integrations are available for this server?

Enables cross-referencing Gmail contacts with LinkedIn profiles and finding LinkedIn profiles for email correspondents, facilitating contact research and networking based on email interactions. Allows pulling LinkedIn profiles and recent posts for upcoming meeting attendees, enabling meeting preparation and relationship intelligence for scheduled events. Supports exporting LinkedIn prospect summaries and network data to Notion for CRM note-taking and relationship management workflows. Enables adding LinkedIn profile summaries and professional intelligence to Obsidian notes for personal knowledge management and CRM purposes.

How do I use LinkedIn Intelligence MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@LinkedIn Intelligence MCP Server Find VPs of Engineering at Series B fintech companies in NYC" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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

Analyze trending topics from industry thought leaders
Develop a unique perspective with Claude's help
Publish to your blog (via another MCP)
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

Go to LinkedIn Developer Portal
Click "Create app"
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
Go to Products → Request "Share on LinkedIn" (instant approval)
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:

Quit Claude Desktop completely
Reopen Claude Desktop
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

FastMCP - MCP SDK for Python
Model Context Protocol - AI tool protocol
Playwright - Browser automation

Built for professionals who value authentic engagement over automation.

LinkedIn Content Intelligence Platform

A Content-First Approach to LinkedIn

The Power of AI-Assisted Workflows

Who Is This For?

Content Creators & Thought Leaders

Marketing & Brand Teams

Professionals Building Their Brand

Analysts & Researchers

Features

Content Creation

Content Planning

Profile Research

Company Research

Analytics & Engagement

Messaging & Conversations

Connections & Networking

Job Intelligence

Quick Start

Prerequisites

Installation

LinkedIn Developer Setup

Configuration

Authentication

Connect to Claude Desktop

Connect to Claude Code

Usage Examples

Content Creator Workflow

Content Planning

Profile Research

Company Research

Available Tools

Content Creation

Draft Management

Scheduling

Profile Research

Company Research

Analytics

Messaging

Connections

Job Search

CLI Commands

Configuration Reference

Limitations

Troubleshooting

Security

Development

Architecture

Intelligent API Fallback

License

Acknowledgments

Resources

Tools

New MCP Servers

Latest Blog Posts

MCP directory API