LinkedIn MCP Server (TypeScript / Bun)

Disclaimer: This is an independent, community-driven open-source project. It is not affiliated with, sponsored by, authorized by, or endorsed by LinkedIn Corporation or Microsoft Corporation. "LinkedIn" is a registered trademark of LinkedIn Corporation and is used purely descriptively.

A blazing-fast, lightweight Model Context Protocol (MCP) server for LinkedIn automation and scraping, rewritten in TypeScript and powered by the Bun runtime.

It provides AI assistants (such as Claude Desktop, Cursor, OpenCode, VS Code, and Windsurf/Antigravity) with 19 production-grade MCP tools to navigate profiles, search jobs and companies, interact with messages, and extract feeds using your own authenticated browser session.

⚡ Why TypeScript + Bun?

linkedin-mcp-server-ts is a native TypeScript/Bun port of stickerdaniel/linkedin-mcp-server, built to deliver maximum efficiency and minimal resource footprint:

• 🚀 Instant Startup & Near-Zero Overhead: Bun's native JIT and fast package execution eliminate cold-start delays.

• 🌐 Native WebView & Direct CDP Engine: Automates Chromium through direct Chrome DevTools Protocol (CDP) and Bun.WebView without heavy external browser daemon layers.

• 🔄 100% Contract & Schema Parity: Complete 1:1 drop-in replacement for the Python MCP server tools, schemas, and return formats.

• 🔑 Seamless Session Sharing: 100% compatible with the standard ~/.linkedin-mcp/profile session storage and cookies format.

Architecture Comparison

🛠️ MCP Tools Overview (19 Tools)

🚀 Quickstart

Prerequisites

1. Install Bun (v1.2 or higher):

   # Windows (PowerShell)
   powershell -c "irm bun.sh/install.ps1 | iex"
   
   # macOS / Linux
   curl -fsSL https://bun.sh/install | bash

2. Google Chrome / Chromium: Installed on your system.

One-Command Execution (bunx)

You can run the server directly without manual installation using bunx:

bunx linkedin-mcp-server-ts

Local Clone & Development Setup

# Clone the repository
git clone https://github.com/joaovjo/linkedin-mcp-server-ts.git
cd linkedin-mcp-server-ts

# Install dependencies
bun install

# Start the server (stdio mode for MCP clients)
bun run start

# Start the HTTP server (for web MCP debugging)
bun run dev

💻 MCP Client Configuration

1. Claude Desktop

Add to your claude_desktop_config.json:

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "linkedin": {
      "command": "bunx",
      "args": ["linkedin-mcp-server-ts"]
    }
  }
}

Or when running from a local clone:

{
  "mcpServers": {
    "linkedin": {
      "command": "bun",
      "args": ["run", "src/index.ts"],
      "cwd": "D:/linkedin/linkedin-mcp-server-ts"
    }
  }
}

2. Cursor

Add to your project's .cursor/mcp.json or Global Cursor Settings:

{
  "mcpServers": {
    "linkedin": {
      "command": "bunx",
      "args": ["linkedin-mcp-server-ts"]
    }
  }
}

3. OpenCode

Add to your opencode.json (or ~/.config/opencode/opencode.json):

{
  "mcp": {
    "linkedin": {
      "type": "stdio",
      "command": "bunx",
      "args": ["linkedin-mcp-server-ts"]
    }
  }
}

4. Antigravity / Windsurf / VS Code (Cline / Roo Code)

Add to mcp_config.json:

{
  "mcpServers": {
    "linkedin": {
      "command": "bunx",
      "args": ["linkedin-mcp-server-ts"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

5. Streamable HTTP Mode

To expose the server over HTTP for remote agents or containerized setups:

bun run src/index.ts --transport streamable-http --host 127.0.0.1 --port 8000

Endpoint URL: http://127.0.0.1:8000/mcp
Healthcheck: http://127.0.0.1:8000/health

🔐 Authentication & Session Management

The server uses a persistent browser profile stored at ~/.linkedin-mcp/profile so you only need to authenticate once.

Option A: Auto-Import from your Everyday Browser (Fastest)

If you are already logged in to LinkedIn in your browser (Chrome, Brave, Edge, Arc, Vivaldi), import your session instantly:

# Auto-detect the most recent browser session
bunx linkedin-mcp-server-ts --import-from-browser

# Or specify a target browser
bunx linkedin-mcp-server-ts --import-from-browser brave
bunx linkedin-mcp-server-ts --import-from-browser chrome
bunx linkedin-mcp-server-ts --import-from-browser edge

Option B: Interactive Visual Login

Launch an interactive Chrome window to log in:

bunx linkedin-mcp-server-ts --login
# Or from local source:
bun run login

1. A Chrome browser window will open to the LinkedIn login page.

2. Complete your login (including 2FA / CAPTCHA if prompted).

3. The server detects successful navigation to your feed and saves your session profile securely.

Check Session Status

bunx linkedin-mcp-server-ts --status
# Or from local source:
bun run status

Logout & Clear Session

bunx linkedin-mcp-server-ts --logout
# Or from local source:
bun run logout

⚙️ Configuration & Environment Variables

Create a .env file in the root directory (or pass CLI arguments) to customize behavior:

🧪 Development, Testing & Quality

Run Contract & Unit Tests

Run the full test suite verifying all 19 tools, schema validations, link metadata classifiers, and error handling:

bun test

Linting & Formatting

Code style and formatting are enforced with Biome:

# Check code for lint issues
bun run lint

# Auto-fix formatting and linting
bun run lint:fix

# Format files
bun run format

Project Architecture

linkedin-mcp-server-ts/
├── src/
│   ├── index.ts               # CLI Entrypoint & Transport routing (stdio / HTTP)
│   ├── config.ts              # CLI flags & environment configuration
│   ├── browser/
│   │   ├── auth.ts            # Login, logout, status, and browser cookie importer
│   │   ├── cdp.ts             # Direct Chrome DevTools Protocol helper functions
│   │   ├── chrome-launch.ts   # Process launcher for visual login & remote attach
│   │   ├── manager.ts         # Bun.WebView & CDP lifecycle manager
│   │   └── types.ts           # Browser status types
│   ├── errors/                # Unified error handling & custom error hierarchy
│   ├── mcp/
│   │   └── create-server.ts   # MCP Server registration & tool mounting
│   ├── middleware/            # Concurrency serialization queue
│   ├── scraping/              # DOM extraction, noise removal, link classification & URNs
│   ├── session/               # Cookie storage, profile directories, and persistence
│   ├── tools/                 # 19 MCP tool implementations
│   └── utils/                 # General helpers
├── tests/                     # Bun test suite & contract validations
├── bunfig.toml                # Bun configuration & npm publish registry settings
└── package.json               # Package metadata, dependencies, and scripts

📦 Publishing to NPM

This project uses bunfig.toml to publish directly to the npm registry with Bun:

# Verify typecheck & tests pass
bun test
bun run lint

# Publish public package
bun publish

🤝 Contributing

Contributions, bug reports, and pull requests are welcome!

1. Fork the repository on GitHub: https://github.com/joaovjo/linkedin-mcp-server-ts

2. Create a feature branch: git checkout -b feature/amazing-feature

3. Commit your changes: git commit -m 'feat: add amazing feature'

4. Ensure all tests pass: bun test && bun run lint

5. Push to the branch: git push origin feature/amazing-feature

6. Open a Pull Request.

📄 License & Credits

• License: Distributed under the MIT License.

• Credits: Special thanks to Daniel Sticker and contributors of stickerdaniel/linkedin-mcp-server for the original Python architecture, scraper logic, and research.