@maheidem/linkedin-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@maheidem/linkedin-mcp Create a LinkedIn post about AI trends for tech professionals"
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.
@maheidem/linkedin-mcp
A comprehensive LinkedIn API MCP (Model Context Protocol) server that integrates seamlessly with Claude Desktop/Code. This package provides full LinkedIn functionality including post creation, profile optimization, content generation, and analytics - all accessible through Claude's natural language interface.
π Quick Start
Install and configure with a single command:
npx @maheidem/linkedin-mcp installThat's it! The installer will:
β Install the MCP server
β Automatically configure Claude Desktop/Code
β Set up token storage
β Provide setup instructions
Related MCP server: LinkedIn Intelligence MCP Server
π Features
β¨ Core Functionality
π LinkedIn Posting: Create and publish posts with full formatting
π Profile Analytics: Get detailed insights and optimization recommendations
π Content Analytics: Track post performance and engagement metrics
π― Content Generation: AI-powered post creation with industry best practices
π€ Profile Management: Update and optimize LinkedIn profiles
π Secure OAuth: Robust token management with automatic refresh
π Developer Features
π± Cross-Platform: Works on Windows, macOS, and Linux
π§ CLI Management: Easy installation, configuration, and maintenance
π Comprehensive API: All LinkedIn REST API endpoints available
π Security First: Secure token storage and handling
π Full Documentation: Complete API reference and examples
π¦ Installation Methods
Method 1: NPX Install (Recommended)
npx @maheidem/linkedin-mcp installMethod 2: Global Install + Setup
npm install -g @maheidem/linkedin-mcp
linkedin-mcp installMethod 3: Local Install
npm install @maheidem/linkedin-mcp
npx linkedin-mcp installπ§ CLI Commands
Installation & Setup
# Install and configure for Claude
linkedin-mcp install
# Check installation status
linkedin-mcp status
# Set up LinkedIn OAuth credentials
linkedin-mcp auth
# Remove configuration
linkedin-mcp uninstallUsage Examples
# Check if everything is working
linkedin-mcp status
# Set up authentication
linkedin-mcp authπ Authentication Setup
After installation, you need to set up LinkedIn OAuth:
Create LinkedIn App:
Go to LinkedIn Developers
Create a new app
Note your Client ID and Client Secret
Configure Redirect URI:
Add
http://localhost:3000/callbackto your app's redirect URIs
Set Up Credentials:
linkedin-mcp authComplete OAuth Flow:
Use the LinkedIn OAuth flow to get an access token
The token will be automatically managed by the MCP server
π― Usage with Claude
Once installed, you can use LinkedIn functionality directly in Claude:
Creating Posts
Create a LinkedIn post about the latest developments in AI, targeting ML engineers and including relevant hashtags.Profile Optimization
Analyze my LinkedIn profile and provide optimization recommendations for better visibility in the tech industry.Content Strategy
Generate 5 LinkedIn post ideas about machine learning trends, each with different engagement strategies.Analytics & Insights
Show me the performance metrics for my last 10 LinkedIn posts and identify the most engaging content types.π Available Tools
The MCP server provides these tools to Claude:
π Posting & Content
linkedin_create_post- Create and publish postslinkedin_create_optimized_post- AI-generated optimized postslinkedin_post_profile_update- Announce profile changes
π Analytics & Data
linkedin_get_user_posts- Retrieve your posts with paginationlinkedin_get_post_details- Detailed post analyticslinkedin_get_user_activity- Activity timeline and engagement
π€ Profile Management
linkedin_get_user_info- User profile informationlinkedin_analyze_profile_from_data- Profile optimization analysislinkedin_generate_optimized_content- Content generation for profiles
π Authentication
linkedin_get_auth_url- Generate OAuth URLslinkedin_exchange_code- Handle OAuth token exchange
π§ Configuration
Claude Configuration Location
The installer automatically detects and configures:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%/Claude/claude_desktop_config.jsonLinux:
~/.config/claude/claude_desktop_config.json
Token Storage
Tokens are securely stored at:
All Platforms:
~/.linkedin-mcp/tokens/
Example Configuration
{
"mcpServers": {
"linkedin-complete": {
"command": "node",
"args": ["/path/to/server/linkedin-complete-mcp.js"],
"env": {
"LINKEDIN_TOKEN_STORAGE_PATH": "/home/user/.linkedin-mcp/tokens"
}
}
}
}π Troubleshooting
Installation Issues
# Check status
linkedin-mcp status
# Reinstall if needed
linkedin-mcp uninstall
linkedin-mcp installAuthentication Problems
# Reset credentials
linkedin-mcp auth
# Check token storage
ls ~/.linkedin-mcp/tokens/Claude Integration Issues
Restart Claude Desktop/Code after installation
Check configuration file location matches your system
Verify MCP server permissions
Common Solutions
"Server not found": Run
linkedin-mcp installagain"Token expired": The server automatically refreshes tokens
"Permission denied": Check file permissions on token directory
π API Reference
Core Methods
Creating Posts
// Through Claude's natural language interface:
"Create a post about AI trends with these key points: [points]"
// Direct API usage:
linkedin_create_post({
text: "Your post content here",
visibility: "PUBLIC"
})Profile Analysis
linkedin_analyze_profile_from_data({
name: "Your Name",
currentHeadline: "Current headline",
industry: "Technology"
})See API_REFERENCE.md for complete documentation.
π Security & Privacy
π Secure Storage: Tokens encrypted and stored locally
π Auto-Refresh: Automatic token renewal
π« No Data Collection: No analytics or tracking
π Local First: All processing happens on your machine
π€ Contributing
Contributions welcome! Please see our contributing guidelines.
Development Setup
git clone https://github.com/maheidem/linkedin-mcp
cd linkedin-mcp
npm install
npm run buildTesting & Examples
# Run unit tests
npm test
# Run example scripts
npm run test:examples
npm run test:oauth
# Try the demo
npm run demo
# Development mode
npm run devProject Structure
βββ src/ # TypeScript source code
βββ dist/ # Compiled JavaScript
βββ examples/ # Usage examples and demos
βββ tests/ # Test files
βββ docs/ # Documentation
βββ configs/ # Configuration templates
βββ .github/workflows/ # CI/CD workflowsπ License
MIT License - see LICENSE file for details.
π Acknowledgments
Built with:
π Support
π Issues: GitHub Issues
π Documentation: Full Docs
π¬ Discussions: GitHub Discussions
Made with β€οΈ for the Claude community
Available Tools
13 toolslinkedin_analyze_profile_from_dataC
Analyze LinkedIn profile data and provide optimization recommendations
Inputs: name (required), currentHeadline, currentSummary, skills, +2 more.
linkedin_create_optimized_postC
β¨ Generate and create an optimized LinkedIn post
Inputs: accessToken (required), topic (required), role (required), industry, +3 more.
linkedin_create_postC
π Create a LinkedIn post (WORKING!)
Inputs: accessToken (required), text (required), visibility.
linkedin_exchange_codeB
Exchange authorization code for access token
Inputs: code (required).
linkedin_generate_optimized_contentC
Generate optimized LinkedIn content (headlines, summaries, posts)
Inputs: contentType (required), currentRole (required), skills, achievements, +2 more.
linkedin_get_auth_urlA
Generate LinkedIn OAuth authorization URL
Inputs: state.
linkedin_get_feedC
π° Get LinkedIn feed/timeline posts
Inputs: accessToken (required), count, start.
linkedin_get_post_commentsC
π¬ Get comments on a specific post
Inputs: accessToken (required), postId (required), count, start.
linkedin_get_post_detailsC
π Get detailed information about a specific post
Inputs: accessToken (required), postId (required), includeStats.
linkedin_get_user_activityB
π Get user's recent activity (likes, comments, shares)
Inputs: accessToken (required), activityTypes, count, start.
linkedin_get_user_infoC
Get user information via OpenID Connect
Inputs: accessToken (required).
linkedin_get_user_postsA
π Get user's own posts with pagination
Inputs: accessToken (required), count, start.
linkedin_post_profile_updateC
π’ Create a post announcing your profile updates
Inputs: accessToken (required), updateType (required), details (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 13 tools
Most tools are clearly distinct, but there is some overlap between linkedin_create_post, linkedin_create_optimized_post, and linkedin_post_profile_update, which all create posts. The first two are distinguished by optimization, but the third could be confused as a different action. Overall, boundaries are mostly clear.
All tools follow a consistent linkedin_verb_noun pattern using snake_case. Verbs like create, get, generate, and post are used predictably. The naming is uniform and easy to parse, with no mixing of conventions.
With 13 tools, the server covers a substantial but focused set of LinkedIn operationsβauth, profile, posts, feed, comments, and activity. This is well within the typical 3-15 range and feels complete without being bloated.
The tool surface covers the main LinkedIn use cases (auth, profile, posts, feed, comments, activity, optimization). Minor gaps exist, such as lacking update/delete operations for posts or comments, but the core workflows are supported and agents can operate without major dead ends.
Related MCP Connectors
Save, illustrate, schedule, and publish LinkedIn posts from Claude, ChatGPT, or any MCP client.
Publish and schedule LinkedIn posts from your AI assistant.
LinkedIn MCP for Claude, ChatGPT, Grok, Hermes: triage inbox, comment, find people, live profiles
LinkedIn outreach from Claude: invites under safe caps, follow-ups, replies and inbox triage.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA powerful LinkedIn Profile Analyzer that seamlessly integrates with Claude AI to fetch and analyze public LinkedIn profiles, enabling users to extract, search, and analyze posts data through RapidAPI's LinkedIn Data API.35MIT
- AlicenseBqualityDmaintenanceConnects Claude Desktop to LinkedIn's data layer for AI-powered networking, enabling profile research, content creation and scheduling, engagement automation, analytics tracking, and messaging through natural language.8546MIT
- AlicenseAqualityDmaintenanceEnables Claude Desktop to manage your LinkedIn profile and company pages, including posting, reading posts, and fetching profile information.7156 npm4MIT
- AlicenseNot gradedqualityDmaintenanceEnables Claude AI to interact with LinkedIn through browser automation, including profile reading, people and job search, company research, post publishing, and profile editing.MIT