Linkedin Automation

A comprehensive AI-powered LinkedIn automation platform built on the Model Context Protocol (MCP) architecture. This sophisticated system combines advanced AI content generation, browser automation, and business intelligence extraction to provide a complete LinkedIn automation suite for content creators, marketers, sales professionals, and business development teams.

🌟 Key Features

🤖 AI-Powered Content Generation

• Smart Content Creation: Generate viral LinkedIn posts using Google Gemini AI
• Topic Research: Analyze existing LinkedIn content for trending topics and insights
• Engagement Optimization: Create posts optimized for maximum engagement and reach
• Content Strategy: Professional storytelling frameworks and thought leadership positioning

📊 Business Intelligence & Analytics

• 🏢 Company Analysis: Extract comprehensive employee data from LinkedIn companies
• 👤 Profile Intelligence: Deep profile data extraction with AI-powered insights
• 📈 Market Research: Competitive analysis and industry intelligence gathering
• 🎯 Lead Generation: Automated prospect identification and data collection

🤝 Sales & Networking Automation

• 🔗 Connection Automation: Send personalized connection requests at scale
• � AI Personalization: Generate custom messages based on profile analysis
• 📱 Outreach Management: Streamlined LinkedIn outreach workflows
• 🎯 Targeted Networking: Strategic connection building based on company and role targeting

🛠️ Technical & Operational

• ⚡ Health Monitoring: Comprehensive server health checks and status monitoring
• � Multi-Deployment: MCP server, standalone, and cloud deployment options
• 🐳 Docker Ready: Complete containerization for cloud deployment
• 🔒 Session Management: Persistent LinkedIn authentication and state management

🚀 Quick Start

🚀 Quick Start: LinkedIn MCP Automation Suite

This guide will help you set up and run the LinkedIn MCP (Model Context Protocol) automation server on your local machine. The instructions are designed for clarity and accuracy, with no exaggeration or unnecessary complexity.

---

1. Prerequisites

• Python 3.11 or higher must be installed.
  Download Python

• Google Gemini API key (for AI-powered features).
  Get your API key here

• LinkedIn account credentials (automation works best with a dedicated account).

• Google Chrome or Chromium browser (required for browser automation).

---

2. Clone the Repository

Open a terminal and run:

git clone https://github.com/YOUR_USERNAME/linkedin-automation-mcp.git
cd linkedin-automation-mcp

---

3. Install Python Dependencies

Install all required packages using pip:

pip install -r requirements.txt

---

4. Set Up Environment Variables

Create a .env file in the root directory with the following content:

[email protected]
LINKEDIN_PASSWORD=your_linkedin_password
GOOGLE_API_KEY=your_gemini_api_key_here

• Do not share your .env file publicly.
• These credentials are required for all LinkedIn and AI-powered features.

---

5. Install Playwright Browser

Install the Chromium browser for Playwright automation:

playwright install chromium

---

6. Start the MCP Server

You can run the server in two ways:

A. Standard MCP Server (for local use or with MCP clients):

python src/server.py

B. Uvicorn Server (for advanced or cloud use):

python src/main.py

---

7. Using the Tools

You can access the automation tools in three ways:

• Via an MCP client (such as Claude Desktop):
  Connect to the running server and invoke tools like generate_linkedin_content, extract_linkedin_profile_data, extract_company_employees, send_connection_request, and scrape_linkedin_post.

• Direct script execution:
  For quick content generation, run:

  python PostLinkedin.py
  

• API endpoint (if using Uvicorn):
  Advanced users can integrate with the HTTP API.

---

8. Project Structure Overview

• src/server.py – Main MCP server entry point; registers all automation tools.
• src/main.py – Alternative entry point using Uvicorn.
• src/tools/ – Contains all core automation modules:
  • generate_linkedin_content.py – AI-powered post generation.
  • extract_linkedin_profile_data.py – Profile data extraction.
  • extract_company_employees.py – Company employee mapping.
  • send_connection_request.py – Automated connection requests.
  • scrape_linkedin_post.py – Post/comment scraping.
  • linkedin_login.py – Centralized authentication/session management.
  • health_check.py – Server health check endpoint.
• PostLinkedin.py – Standalone script for content generation.
• requirements.txt – Python dependencies.

---

9. Notes & Best Practices

• Session Persistence:
  The system saves your LinkedIn login session to linkedin-state.json for faster, less intrusive automation.

• Security:
  All credentials are managed via environment variables. Do not commit your .env file.

• Compliance:
  Use a dedicated LinkedIn account for automation. Respect LinkedIn’s terms of service.

---

10. Troubleshooting

• If you see login errors, double-check your credentials in .env.
• If Playwright fails, ensure Chromium is installed (playwright install chromium).
• For AI errors, verify your Google Gemini API key and internet connection.

---

---

11. Connecting MCP to Claude Desktop

To use the LinkedIn MCP server with Claude Desktop (or any MCP-compatible client):

1. Start the MCP server (see step 6 above).

2. Configure Claude Desktop to recognize your local MCP server:

   • Open the Claude Desktop settings or configuration file (usually settings.json or similar).

   • Add or update the mcpServers section as follows (adjust the args path to match the location of src/server.py on your system):

   {
     "mcpServers": {
       "linkedin-mcp": {
         "command": "python",
         "args": ["/absolute/path/to/src/server.py"],
         "env": {
           "LINKEDIN_USERNAME": "[email protected]",
           "LINKEDIN_PASSWORD": "your_linkedin_password",
           "GOOGLE_API_KEY": "your_gemini_api_key_here"
         }
       }
     }
   }
   

   • The command and args fields must point to the correct Python executable and the full path to src/server.py on your machine. For example, if your project is cloned to C:/Users/YourName/linkedin-automation-mcp/, then use:

     "args": ["C:/Users/YourName/linkedin-automation-mcp/src/server.py"]
     

   • Use your actual credentials and API key (never share these publicly).

3. Restart Claude Desktop. The LinkedIn MCP tools will now appear as available actions or plugins.

4. Invoke tools like generate_linkedin_content, extract_linkedin_profile_data, etc., directly from Claude Desktop's interface.

---

For questions or issues, please open a GitHub issue or contact the project maintainer.