LinkedIn MCP Server Documentation
About
Model Context Protocol (MCP) server for LinkedIn integration with n8n
Details
- Author
- wedlock666
- Downloads
- 317
- Categories
- Knowledge Base
Jump to
- Profile management (view and search profiles)
- Connection management (send requests, list connections, pending requests)
- Messaging (send messages and read conversations)
- Post interaction (create, like, comment, share)
- Job search (search, view details, apply)
- MCP protocol support for seamless n8n integration
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
LinkedIn MCP Server DocumentationCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install Node.js v16+, clone the repository, run npm install, copy .env.example to .env, edit the file with your LinkedIn credentials (LINKEDIN_USERNAME and LINKEDIN_PASSWORD) plus JWT and cookie secrets, then start the server with ./start.sh. All MCP requests are sent via JSON‑RPC 2.0 to the POST /mcp endpoint.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"linkedin mcp server documentation": {
"mcp-linkedin-server": {
"command": "docker",
"args": [
"build",
"-t",
"linkedin-mcp-server",
"."
]
}
}
}
}McpServers
{
"mcp-linkedin-server": {
"command": "docker",
"args": [
"build",
"-t",
"linkedin-mcp-server",
"."
]
}
}LinkedIn MCP Server Documentation
Table of Contents
1. Introduction
2. Architecture Overview
3. Installation Guide
4. Configuration
5. API Reference
6. LinkedIn Functionality
7. n8n Integration
8. Deployment Guide
9. Testing
10. Troubleshooting
11. Security Considerations
12. Limitations and Compliance
Introduction
The LinkedIn MCP Server is a Model Context Protocol (MCP) implementation that enables integration between n8n and LinkedIn without requiring official API access. It uses web automation techniques with Puppeteer to interact with LinkedIn's web interface, providing functionality for profile management, connections, messaging, posts, and job searching.
Purpose
This server allows you to automate LinkedIn interactions through n8n workflows, enabling various use cases:
- Automated connection management
- Profile data extraction and analysis
- Messaging automation
- Content posting and engagement
- Job search and application processes
Key Features
- Profile Management: View and search LinkedIn profiles
- Connection Management: Send connection requests and manage connections
- Messaging: Send messages and read conversations
- Post Interaction: Create, like, comment on, and share posts
- Job Search: Search for jobs, view details, and apply when possible
- MCP Protocol Support: Seamless integration with n8n through the Model Context Protocol
Architecture Overview
The LinkedIn MCP Server follows a modular architecture designed for maintainability and extensibility:
Core Components
1. MCP Server Core: Implements the JSON-RPC 2.0 based protocol with SSE support
2. LinkedIn Automation Engine: Uses Puppeteer for web automation
3. LinkedIn Functionality Modules: Provides specific LinkedIn features
4. n8n Integration Layer: Connects the MCP server to n8n workflows
Technical Stack
- Node.js: Runtime environment
- Express.js: Web server framework
- Puppeteer: Headless browser automation
- Puppeteer-Extra: Enhanced Puppeteer with stealth capabilities
- Winston: Logging system
- JSON-RPC 2.0: Communication protocol for MCP
Directory Structure
mcp-linkedin-project/
├── src/
│ ├── index.js # Main entry point
│ ├── routes/ # API routes
│ │ └── mcp.js # MCP protocol routes
│ ├── controllers/ # Business logic
│ │ └── linkedin-controller.js # LinkedIn functionality controller
│ ├── services/ # Core services
│ │ ├── browser.js # Puppeteer browser management
│ │ ├── linkedin-auth.js # LinkedIn authentication
│ │ ├── linkedin-profile.js # Profile functionality
│ │ ├── linkedin-connection.js # Connection functionality
│ │ ├── linkedin-messaging.js # Messaging functionality
│ │ ├── linkedin-post.js # Post functionality
│ │ └── linkedin-job.js # Job functionality
│ ├── models/ # Data models
│ ├── utils/ # Utility functions
│ └── config/ # Configuration files
├── test/ # Test scripts
│ ├── test-mcp.js # MCP server tests
│ ├── n8n-webhook-test.js # n8n webhook simulator
│ └── n8n-workflow-example.js # Example n8n workflow
├── docs/ # Documentation
├── .env.example # Environment variables template
├── package.json # Dependencies and scripts
├── start.sh # Server start script
└── test.sh # Test runner script
Installation Guide
Prerequisites
- Node.js (v16 or higher)
- npm (v7 or higher)
- A LinkedIn account
- Internet access
Local Installation
1. Clone the repository or download the source code:
git clone https://github.com/yourusername/mcp-linkedin-project.git
cd mcp-linkedin-project
2. Install dependencies:
npm install
3. Create environment configuration:
cp .env.example .env
4. Edit the .env file with your LinkedIn credentials and other settings:
```
PORT=3000
MCP_SERVER_NAME="LinkedIn MCP Server"
MCP_SERVER_VERSION="0.1.0"
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
