Which integrations are available for this server?

Leverages Google Gemini models for AI-driven content creation, analysis, and recommendation features, including post generation, trend analysis, and multi-lingual support. Provides access to OpenAI's GPT-4 models for generating, rewriting, translating, and optimizing LinkedIn content, as well as powering other AI-assisted tasks like lead scoring and engagement strategies.

How do I use LinkedIn Automation MCP Server?

1. Click on "Deploy 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 Automation MCP Server Find tech leads in San Francisco" 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 Automation MCP Server

by abdulsammad-lgtm

Overview Schema Source Related Servers Discussions Admin

TypeScript

Hybrid

LinkedIn Automation MCP Server

Overview

Enterprise-grade MCP (Model Context Protocol) server that enables AI assistants to manage LinkedIn workflows through secure, composable tools. Combines AI-powered content generation, lead management, profile optimization, message outreach, analytics, scheduling, and industry research into a single extensible platform.

Related MCP server: MCP LinkedIn Sales Navigator

Features

Category	Tools
Content Generation	Generate posts, rewrite content, hooks, CTAs, carousels, articles, polls, translations, hashtags, repurpose content across 10 content types and 10 tones
Profile Optimization	Full profile analysis, headline/About generation, SEO scoring, skill recommendations, banner suggestions
Lead Management	Find prospects by industry/company/location/title, score leads, save/export (CSV/JSON), paginated retrieval
Message Outreach	Connection requests, follow-ups, thank-you, meeting requests, sales outreach, recruitment, networking messages
Engagement Strategy	Post recommendations, comment generation, engagement strategies, conversation starters, industry trend analysis
Analytics & Insights	Performance metrics, post analysis, top content, growth trends, AI recommendations, best posting times
Content Calendar	Create calendars, schedule posts, publish, save drafts, recurring posts, timezone-aware scheduling
Industry Research	Trend research, content ideas, competitor analysis, trending hashtags
Multi-AI Provider	OpenAI GPT-4, Anthropic Claude 3, Google Gemini — switchable per request
Vector Memory	Qdrant-based semantic storage for writing style, brand voice, company knowledge, successful posts, RAG

Quick Start

git clone <repo>
cd linkedin-automation-mcp
npm install
cp .env.example .env
# Edit .env with your API keys
npm run dev

Architecture

The server follows Clean Architecture with strict separation of concerns across six layers:

┌─────────────────────────────────────────────────────────────────────┐
│                        AI Client (Claude, Cursor, etc.)              │
└──────────────────────────────┬──────────────────────────────────────┘
                               │ MCP Protocol (stdio)
                               ▼
┌──────────────────────────────────────────────────────────────────────┐
│                         MCP Server Layer                             │
│              @modelcontextprotocol/sdk  StdioServerTransport          │
│              Tool registry, request routing, schema validation        │
├──────────────────────────────────────────────────────────────────────┤
│                            Tools Layer                                │
│   Content   Profile   Lead   Message   Engagement   Analytics        │
│   Calendar  Research                                                  │
├──────────────────────────────────────────────────────────────────────┤
│                           Services Layer                              │
│   Business logic, orchestration, validation, AI prompt building       │
├──────────────────────────────────────────────────────────────────────┤
│                         Provider Layer                                │
│   OpenAIProvider   AnthropicProvider   GeminiProvider   LinkedIn      │
├──────────────────────────────────────────────────────────────────────┤
│                           Data Layer                                  │
│   PostgreSQL (Drizzle ORM)    Redis    Qdrant Vector DB              │
└──────────────────────────────────────────────────────────────────────┘

Tech Stack

Category	Technology
Runtime	Node.js 18+, TypeScript 5.3
MCP	`@modelcontextprotocol/sdk` v0.5
HTTP	Express 4.18, Helmet, CORS, Compression
Validation	Zod 3.22
Database	PostgreSQL 16 (Drizzle ORM 0.29)
Vector DB	Qdrant 1.8
Cache	Redis 7 (ioredis)
AI	OpenAI, Anthropic, Google Gemini
Auth	JWT, bcryptjs, LinkedIn OAuth
Logging	Winston 3.11
Scheduling	node-cron 3.0
Testing	Jest 29, Supertest, Nock
Linting	ESLint 8, Prettier 3
CI	Husky 8, lint-staged

Project Structure

linkedin-automation-mcp/
├── src/
│   ├── index.ts                 # Server entry point
│   ├── config/
│   │   └── index.ts             # Environment configuration
│   ├── types/
│   │   └── index.ts             # TypeScript enums, interfaces, types
│   ├── database/
│   │   ├── schema.ts            # Drizzle ORM schema (14 tables)
│   │   ├── connection.ts        # PostgreSQL connection pool
│   │   ├── migrations/          # Database migrations
│   │   ├── index.ts             # Database exports
│   │   └── seed.ts              # Seed data
│   ├── providers/
│   │   ├── ai-provider.ts       # AI provider interface
│   │   ├── openai-provider.ts   # OpenAI GPT-4 implementation
│   │   ├── anthropic-provider.ts # Anthropic Claude 3 implementation
│   │   ├── gemini-provider.ts   # Google Gemini implementation
│   │   └── linkedin-provider.ts # LinkedIn API client
│   ├── services/
│   │   ├── content-service.ts   # Content generation business logic
│   │   ├── profile-service.ts   # Profile optimization logic
│   │   ├── lead-service.ts      # Lead management logic
│   │   ├── message-service.ts   # Message generation logic
│   │   ├── engagement-service.ts # Engagement strategy logic
│   │   ├── analytics-service.ts # Analytics business logic
│   │   ├── research-service.ts  # Research & trends logic
│   │   └── scheduler-service.ts # Cron-based scheduling
│   ├── tools/
│   │   ├── content-tools.ts     # 10 content MCP tools
│   │   ├── profile-tools.ts     # 6 profile MCP tools
│   │   ├── lead-tools.ts        # 5 lead MCP tools
│   │   ├── message-tools.ts     # 7 message MCP tools
│   │   ├── engagement-tools.ts  # 5 engagement MCP tools
│   │   ├── analytics-tools.ts   # 6 analytics MCP tools
│   │   ├── calendar-tools.ts    # 7 calendar MCP tools
│   │   ├── research-tools.ts    # 4 research MCP tools
│   │   ├── utils.ts             # Tool utility functions
│   │   └── index.ts             # Tool registry
│   ├── agents/
│   │   └── index.ts             # AI agent orchestrator
│   ├── memory/
│   │   └── index.ts             # Qdrant vector memory
│   ├── prompts/
│   │   └── index.ts             # AI prompt templates
│   ├── middleware/
│   │   ├── auth.ts              # JWT authentication
│   │   ├── error-handler.ts     # Centralized error handling
│   │   ├── rate-limit.ts        # Rate limiting
│   │   ├── validation.ts        # Zod validation middleware
│   │   ├── async-handler.ts     # Async route handler
│   │   └── log-request.ts       # Request logging
│   ├── routes/
│   │   ├── auth-routes.ts       # Authentication endpoints
│   │   ├── post-routes.ts       # Post management endpoints
│   │   ├── profile-routes.ts    # Profile optimization endpoints
│   │   ├── lead-routes.ts       # Lead management endpoints
│   │   ├── message-routes.ts    # Message endpoints
│   │   ├── analytics-routes.ts  # Analytics endpoints
│   │   ├── calendar-routes.ts   # Calendar endpoints
│   │   └── index.ts             # Route aggregator
│   └── utils/
│       ├── logger.ts            # Winston logger
│       ├── cache.ts             # In-memory cache
│       ├── encryption.ts        # AES-256-GCM encryption
│       ├── helpers.ts           # Utility helpers
│       ├── rate-limiter.ts      # Rate limiter helpers
│       ├── retry.ts             # Retry logic
│       └── validators.ts        # Zod validation schemas
├── dashboard/                   # Admin dashboard (Vite + React)
├── scripts/                     # Utility scripts
├── __tests__/                   # Test files
├── docker-compose.yml           # Docker Compose (app, postgres, qdrant, redis)
├── Dockerfile                   # Multi-stage build
├── .env.example                 # Environment variables template
├── tsconfig.json                # TypeScript configuration
├── jest.config.js               # Unit test configuration
├── jest.e2e.config.js           # E2E test configuration
└── package.json

MCP Tools

The server exposes 50 MCP tools across 8 categories:

Content Tools (10)

Tool	Description	Key Inputs
`generate_post`	Generate a LinkedIn post with full customization	type, tone, audience, industry, topic
`rewrite_post`	Rewrite/improve existing content	content, tone, readabilityLevel
`generate_hashtags`	Generate relevant LinkedIn hashtags	topic, industry, count, trending
`generate_hook`	Generate an engaging post hook	topic, tone
`generate_cta`	Generate a compelling call-to-action	topic, goal
`translate_post`	Translate post preserving tone/hashtags	content, targetLanguage
`generate_carousel`	Generate carousel outline with slides	topic, slides
`generate_article`	Generate long-form LinkedIn article	title, topic, wordCount
`generate_poll`	Generate poll with question and options	topic, options
`repurpose_content`	Repurpose blog/video/podcast to LinkedIn post	sourceContent, sourceType

Profile Tools (6)

Tool	Description	Key Inputs
`optimize_profile`	Full profile optimization analysis	headline, about, skills, industry, targetRole
`generate_headline`	Generate optimized headline (<220 chars)	current, targetRole, industry, keywords
`generate_about`	Generate/optimize About section	current, targetRole, industry, keyPoints
`analyze_profile_seo`	SEO effectiveness analysis	headline, about, skills, experience
`recommend_skills`	Skill recommendations for target role	currentSkills, targetRole, industry
`suggest_banner`	LinkedIn banner design suggestions	industry, branding

Lead Tools (5)

Tool	Description	Key Inputs
`find_leads`	Search for prospects by criteria	industry, company, location, jobTitle, keywords
`score_leads`	Score/qualify leads by fit and intent	prospectIds
`save_leads`	Save leads to database	leads array
`get_leads`	Retrieve saved leads with filters	userId, status, industry, page, limit
`export_leads`	Export leads as CSV or JSON	userId, format

Message Tools (7)

Tool	Description	Key Inputs
`generate_connection_request`	Personalized connection request (<300 chars)	prospectName, senderName, context
`generate_followup`	Follow-up referencing previous conversation	previousMessage, context
`generate_thank_you`	Thank-you message for relationships	context
`generate_meeting_request`	Meeting invitation	meetingPurpose
`generate_sales_outreach`	Value-first sales outreach	product, valueProposition
`generate_recruitment_message`	Recruitment/InMail for talent	role, company
`generate_networking_message`	Networking message based on shared interests	commonInterest

Engagement Tools (5)

Tool	Description	Key Inputs
`recommend_posts`	Recommend posts to engage with	userId, industry, interests
`generate_comment`	Generate value-adding comment	postContent, tone
`get_engagement_strategy`	Like/follow engagement strategy	industry, goals
`get_conversation_starters`	Generate conversation starters	topic, industry
`analyze_industry_trends`	Analyze trends and content opportunities	industry

Analytics Tools (6)

Tool	Description	Key Inputs
`get_analytics`	Get analytics for account/date range	accountId, startDate, endDate, metrics
`analyze_post`	Analyze individual post performance	postId
`get_top_content`	Get top-performing content	accountId, limit
`get_growth_trends`	Follower/engagement growth trends	accountId, period
`get_recommendations`	AI-powered actionable recommendations	analyticsId
`recommend_post_time`	Best times to post for engagement	accountId

Calendar Tools (7)

Tool	Description	Key Inputs
`create_content_calendar`	Create content calendar with slots	name, frequency, slots, startDate, endDate
`schedule_post`	Schedule post for future publishing	postId, scheduledAt, timezone
`publish_post`	Publish post immediately	postId, accountId
`save_draft`	Save post as draft	content, type, tone
`get_calendar`	Get content calendar with scheduled posts	userId, startDate, endDate
`get_drafts`	Get saved drafts with pagination	userId, page, limit
`cancel_scheduled_post`	Cancel scheduled post	postId

Research Tools (4)

Tool	Description	Key Inputs
`research_trends`	Research industry trends and content strategy	industry, topics, contentTypes
`get_content_ideas`	Generate content ideas for industry	industry, topics, contentTypes
`analyze_competitors`	Analyze competitor LinkedIn strategies	industry, topics
`get_trending_hashtags`	Get trending hashtags for industry	industry, topics

Docker Setup

# Build and start all services
docker-compose up -d

# View logs
docker-compose logs -f app

# Stop all services
docker-compose down

# Rebuild after changes
docker-compose build app

The Docker Compose setup includes:

app — Node.js MCP server on port 3001
dashboard — Admin dashboard on port 5173
postgres — PostgreSQL 16 on port 5432
qdrant — Vector database on port 6333
redis — Cache on port 6379

Environment Variables

Variable	Description	Default
`PORT`	HTTP server port	`3001`
`NODE_ENV`	Environment (development/production)	`development`
`API_PREFIX`	REST API base path	`/api/v1`
`DATABASE_URL`	PostgreSQL connection string	`postgresql://...`
`REDIS_URL`	Redis connection string	`redis://localhost:6379`
`QDRANT_URL`	Qdrant vector DB URL	`http://localhost:6333`
`OPENAI_API_KEY`	OpenAI API key	—
`ANTHROPIC_API_KEY`	Anthropic API key	—
`GEMINI_API_KEY`	Google Gemini API key	—
`DEFAULT_AI_PROVIDER`	Default AI provider	`openai`
`LINKEDIN_CLIENT_ID`	LinkedIn OAuth client ID	—
`LINKEDIN_CLIENT_SECRET`	LinkedIn OAuth client secret	—
`JWT_SECRET`	JWT signing secret	—
`JWT_EXPIRES_IN`	JWT token expiry	`7d`
`JWT_REFRESH_SECRET`	Refresh token secret	—
`ENCRYPTION_KEY`	AES-256 encryption key (32 chars)	—
`RATE_LIMIT_WINDOW_MS`	Rate limit window	`900000` (15 min)
`RATE_LIMIT_MAX_REQUESTS`	Max requests per window	`100`
`CORS_ORIGIN`	Allowed CORS origins	`http://localhost:5173`
`LOG_LEVEL`	Logging level	`info`
`SCHEDULER_CRON`	Scheduler cron expression	`0 /6 * *`
`MAX_SCHEDULED_POSTS_PER_DAY`	Max daily scheduled posts	`5`
`CACHE_TTL_SECONDS`	Cache TTL	`300`
`FEATURE_AI_WRITER`	Enable AI writer feature	`true`
`FEATURE_CALENDAR`	Enable calendar feature	`true`
`FEATURE_LEAD_GEN`	Enable lead generation	`true`
`FEATURE_ANALYTICS`	Enable analytics	`true`
`FEATURE_OUTREACH`	Enable outreach	`true`

API Endpoints

Method	Path	Description
`POST`	`/api/v1/auth/register`	Register new user
`POST`	`/api/v1/auth/login`	Login
`POST`	`/api/v1/auth/refresh`	Refresh access token
`POST`	`/api/v1/auth/logout`	Logout
`GET`	`/api/v1/auth/me`	Get current user
`GET`	`/api/v1/auth/linkedin/authorize`	LinkedIn OAuth authorize
`GET`	`/api/v1/auth/linkedin/callback`	LinkedIn OAuth callback
`POST`	`/api/v1/posts/generate`	Generate post
`POST`	`/api/v1/posts/rewrite`	Rewrite post
`POST`	`/api/v1/posts/schedule`	Schedule post
`POST`	`/api/v1/posts/publish`	Publish post
`POST`	`/api/v1/posts/draft`	Save draft
`GET`	`/api/v1/posts`	List posts
`GET`	`/api/v1/posts/drafts`	List drafts
`GET`	`/api/v1/posts/:id`	Get post
`DELETE`	`/api/v1/posts/:id`	Delete post
`POST`	`/api/v1/profile/optimize`	Optimize profile
`POST`	`/api/v1/profile/headline`	Generate headline
`POST`	`/api/v1/profile/about`	Generate About section
`POST`	`/api/v1/profile/seo`	SEO analysis
`POST`	`/api/v1/profile/skills`	Recommend skills
`POST`	`/api/v1/leads/search`	Search leads
`POST`	`/api/v1/leads/score`	Score leads
`POST`	`/api/v1/leads/save`	Save leads
`GET`	`/api/v1/leads`	List leads
`GET`	`/api/v1/leads/export`	Export leads
`DELETE`	`/api/v1/leads/:id`	Delete lead
`POST`	`/api/v1/messages/generate`	Generate message
`POST`	`/api/v1/messages/connection-request`	Generate connection request
`POST`	`/api/v1/messages/followup`	Generate follow-up
`POST`	`/api/v1/messages/send`	Send message
`GET`	`/api/v1/messages`	List messages
`GET`	`/api/v1/analytics`	Get analytics
`GET`	`/api/v1/analytics/posts/:id`	Analyze post
`GET`	`/api/v1/analytics/top`	Top content
`GET`	`/api/v1/analytics/trends`	Growth trends
`POST`	`/api/v1/analytics/recommendations`	Get recommendations
`POST`	`/api/v1/analytics/best-time`	Best posting time
`POST`	`/api/v1/calendar`	Create calendar
`GET`	`/api/v1/calendar`	List calendars
`POST`	`/api/v1/calendar/schedule`	Schedule post
`POST`	`/api/v1/calendar/publish`	Publish post
`POST`	`/api/v1/calendar/draft`	Save draft
`GET`	`/api/v1/calendar/drafts`	List drafts
`DELETE`	`/api/v1/calendar/scheduled/:id`	Cancel scheduled post
`GET`	`/health`	Health check

Dashboard

The admin dashboard is a Vite + React application in the dashboard/ directory.

# Start dashboard in development mode
npm run dashboard:dev

# Build dashboard for production
npm run dashboard:build

Testing

# Run unit tests
npm test

# Run tests in watch mode
npm run test:watch

# Run tests with coverage
npm run test:coverage

# Run end-to-end tests
npm run test:e2e

Deployment

Production Build

npm run build
npm start

Docker Production

docker-compose -f docker-compose.yml up -d

Environment Configuration

Copy .env.example to .env
Set NODE_ENV=production
Configure strong JWT_SECRET and ENCRYPTION_KEY
Set database credentials
Configure AI provider API keys
Set LinkedIn OAuth credentials

CI/CD Pipeline

# Suggested pipeline stages
- lint:     npm run lint
- typecheck: npm run typecheck
- test:     npm run test:coverage
- build:    npm run build
- docker:   docker-compose build
- deploy:   docker-compose up -d

License

MIT License — see LICENSE

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

SalesTouchOAuth
io.salestouch
Give AI agents the LinkedIn tools to find, qualify, engage, and follow up with prospects.
Social Media CRM Autonomous Agents
22
Reach MCP — LinkedIn for AI agents A
com.reachmcp
LinkedIn for AI agents: inbox, invitations, Sales Navigator search, posts. Quotas and webhooks.
Social Media CRM
521
crispyOAuth
sh.crispy
Full LinkedIn access for AI agents: leads, messaging, and campaigns with safe limits built in.
Social Media CRM Communication
2
linkedin-dataOAuth
com.superagnt
LinkedIn data for AI agents: profiles, companies, jobs, posts, search. Sales research, recruiting.
CRM Search
1

Related MCP Servers

LinkedIn MCP Server
Web Scraping Browser Automation Social Media
stickerdaniel
A
license
A
quality
A
maintenance
Enables AI assistants to interact with LinkedIn by scraping profiles, companies, job postings, and getting personalized job recommendations using authenticated browser automation.
Updated 2 days ago (2026-09-20 20:23 UTC)
17
15,550 PyPI
3,557
Apache 2.0
MCP LinkedIn Sales Navigator
Browser Automation Web Scraping CRM
globodai-group
A
license
A
quality
A
maintenance
Enables AI assistants to search leads, view profiles, manage lists, send InMails, and export data from LinkedIn Sales Navigator through browser automation.
Updated 6 days ago (2026-09-16 22:01 UTC)
8
9
MIT
LinkedIn MCP Server
Social Media Communication
ASISaga
A
license
Not graded
quality
D
maintenance
Enables AI assistants to interact with LinkedIn using the official API for profile access, company management, and job postings.
Updated 5 months ago (2026-04-10 01:22 UTC)
Apache 2.0
Linked API MCP
Social Media Browser Automation Web Scraping
zecloud
A
license
A
quality
B
maintenance
Connects LinkedIn to AI assistants, enabling lead search, profile analysis, messaging, and workflow automation through a cloud browser. Supports sales, recruiting, and market research tasks.
Updated a month ago (2026-08-09 13:05 UTC)
59
194 npm
MIT

LinkedIn Automation MCP Server

Overview

Features

Quick Start

Architecture

Tech Stack

Project Structure

MCP Tools

Content Tools (10)

Profile Tools (6)

Lead Tools (5)

Message Tools (7)

Engagement Tools (5)

Analytics Tools (6)

Calendar Tools (7)

Research Tools (4)

Docker Setup

Environment Variables

API Endpoints

Dashboard

Testing

Deployment

Production Build

Docker Production

Environment Configuration

CI/CD Pipeline

License

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

LinkedIn MCP Server

MCP LinkedIn Sales Navigator

LinkedIn MCP Server

Linked API MCP