LinkedIn MCP Server

LinkedIn MCP Server

Disclaimer: LinkedIn is a registered trademark of LinkedIn Corporation and its affiliates. LinkedIn MCP Server is an independent, unofficial project and is not affiliated with, endorsed by, sponsored by, or associated with LinkedIn Corporation or its affiliates.

A LinkedIn MCP server to find jobs, search people, research companies, manage your network, publish and engage with posts, and read or send messages.

⚡ Quickstart

1. Connect Claude Code

claude mcp add --scope user --transport stdio linkedin-mcp -- \
  uvx --from linkedin-mcp-local linkedin-mcp serve --transport stdio

2. Sign in to LinkedIn

Restart Claude Code. A dedicated browser window opens automatically—sign in to LinkedIn and complete any required verification.

[!NOTE] Your session is saved locally and reused automatically.

Supported platforms

The server runs natively on Windows, macOS, and Linux. CI executes the complete offline suite on Windows, macOS, Linux x86-64, and Linux ARM64. Browser and OS version requirements follow the official Playwright Python system requirements.

3. Try your first request

Find remote software engineering jobs in India posted on LinkedIn this week.

🛠️ Tools

[!TIP] Verified means the tool passed an end-to-end live compatibility test against LinkedIn's visible web UI on the date shown.

NOT CHECKED tools remain covered by the offline simulator on every pull request.

[status-linkedin-jobs-search]: https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Fprakharagarwal-dev%2Flinkedin-mcp-server%2Ftool-status%2Fbadges%2Flinkedin.jobs.search.json&label= [status-linkedin-jobs-get]: https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Fprakharagarwal-dev%2Flinkedin-mcp-server%2Ftool-status%2Fbadges%2Flinkedin.jobs.get.json&label= [status-linkedin-people-search]: https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Fprakharagarwal-dev%2Flinkedin-mcp-server%2Ftool-status%2Fbadges%2Flinkedin.people.search.json&label= [status-linkedin-people-get]: https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Fprakharagarwal-dev%2Flinkedin-mcp-server%2Ftool-status%2Fbadges%2Flinkedin.people.get.json&label= [status-linkedin-companies-search]: https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Fprakharagarwal-dev%2Flinkedin-mcp-server%2Ftool-status%2Fbadges%2Flinkedin.companies.search.json&label= [status-linkedin-companies-get]: https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Fprakharagarwal-dev%2Flinkedin-mcp-server%2Ftool-status%2Fbadges%2Flinkedin.companies.get.json&label= [status-linkedin-posts-search]: https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Fprakharagarwal-dev%2Flinkedin-mcp-server%2Ftool-status%2Fbadges%2Flinkedin.posts.search.json&label= [status-linkedin-posts-get]: https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Fprakharagarwal-dev%2Flinkedin-mcp-server%2Ftool-status%2Fbadges%2Flinkedin.posts.get.json&label= [status-linkedin-posts-comments-list]: https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Fprakharagarwal-dev%2Flinkedin-mcp-server%2Ftool-status%2Fbadges%2Flinkedin.posts.comments.list.json&label= [status-linkedin-posts-create]: https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Fprakharagarwal-dev%2Flinkedin-mcp-server%2Ftool-status%2Fbadges%2Flinkedin.posts.create.json&label= [status-linkedin-posts-comment]: https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Fprakharagarwal-dev%2Flinkedin-mcp-server%2Ftool-status%2Fbadges%2Flinkedin.posts.comment.json&label= [status-linkedin-posts-react]: https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Fprakharagarwal-dev%2Flinkedin-mcp-server%2Ftool-status%2Fbadges%2Flinkedin.posts.react.json&label= [status-linkedin-connections-list]: https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Fprakharagarwal-dev%2Flinkedin-mcp-server%2Ftool-status%2Fbadges%2Flinkedin.connections.list.json&label= [status-linkedin-connections-search]: https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Fprakharagarwal-dev%2Flinkedin-mcp-server%2Ftool-status%2Fbadges%2Flinkedin.connections.search.json&label= [status-linkedin-invitations-list]: https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Fprakharagarwal-dev%2Flinkedin-mcp-server%2Ftool-status%2Fbadges%2Flinkedin.invitations.list.json&label= [status-linkedin-messaging-search]: https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Fprakharagarwal-dev%2Flinkedin-mcp-server%2Ftool-status%2Fbadges%2Flinkedin.messaging.search.json&label= [status-linkedin-messaging-conversation-get]: https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Fprakharagarwal-dev%2Flinkedin-mcp-server%2Ftool-status%2Fbadges%2Flinkedin.messaging.conversation.get.json&label= [status-linkedin-messaging-send]: https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Fprakharagarwal-dev%2Flinkedin-mcp-server%2Ftool-status%2Fbadges%2Flinkedin.messaging.send.json&label= [status-linkedin-server-status]: https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Fprakharagarwal-dev%2Flinkedin-mcp-server%2Ftool-status%2Fbadges%2Flinkedin.server.status.json&label= [status-linkedin-session-status]: https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Fprakharagarwal-dev%2Flinkedin-mcp-server%2Ftool-status%2Fbadges%2Flinkedin.session.status.json&label= [status-linkedin-capabilities-list]: https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Fprakharagarwal-dev%2Flinkedin-mcp-server%2Ftool-status%2Fbadges%2Flinkedin.capabilities.list.json&label= [status-checked-on]: https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Fprakharagarwal-dev%2Flinkedin-mcp-server%2Ftool-status%2Fbadges%2Fchecked-on.json&label= [status-not-checked]: https://img.shields.io/badge/status-not_checked-lightgrey?label=

See the capability matrix for exact filters, supported formats, inputs, outputs, limits, and unsupported features.

📦 Installation

Claude Code

claude mcp add --scope user --transport stdio linkedin-mcp -- \
  uvx --from linkedin-mcp-local linkedin-mcp serve --transport stdio

Check it with claude mcp list. See the Claude Code MCP documentation.

Claude Desktop

Download the .mcpb file, then open Settings → Extensions → Advanced settings → Install Extension. See Claude Desktop's extension documentation.

Codex and ChatGPT Desktop

codex mcp add linkedin-mcp -- \
  uvx --from linkedin-mcp-local linkedin-mcp serve --transport stdio

Check it with codex mcp list. Codex CLI, the Codex IDE extension, and ChatGPT Desktop share this local configuration. Restart the client after adding it. See the Codex MCP documentation.

VS Code and GitHub Copilot

Or add this to .vscode/mcp.json:

{
  "servers": {
    "linkedin-mcp": {
      "command": "uvx",
      "args": ["--from", "linkedin-mcp-local", "linkedin-mcp", "serve", "--transport", "stdio"]
    }
  }
}

See the VS Code MCP documentation.

Cursor

For manual setup, open Cursor Settings → MCP → Add new MCP server, set the command to uvx, and set the arguments to --from linkedin-mcp-local linkedin-mcp serve --transport stdio. See the Cursor MCP documentation.

Gemini CLI

In ~/.gemini/settings.json, add a local server named linkedin-mcp under mcpServers with command uvx and arguments --from linkedin-mcp-local linkedin-mcp serve --transport stdio, then run gemini mcp list. See the Gemini CLI MCP documentation.

Windsurf

Open Settings → AI → Manage MCP Servers, or add a local server named linkedin-mcp to ~/.codeium/windsurf/mcp_config.json with command uvx and arguments --from linkedin-mcp-local linkedin-mcp serve --transport stdio. See the Windsurf MCP documentation.

Cline

Open MCP Servers → Configure, then add a local server named linkedin-mcp with command uvx and arguments --from linkedin-mcp-local linkedin-mcp serve --transport stdio. See the Cline MCP documentation.

Roo Code

Open Roo Code's MCP settings and add a local server named linkedin-mcp to the global file or .roo/mcp.json, using command uvx and arguments --from linkedin-mcp-local linkedin-mcp serve --transport stdio. See the Roo Code MCP documentation.

Zed

Add this to Zed settings:

{
  "context_servers": {
    "linkedin-mcp": {
      "command": "uvx",
      "args": ["--from", "linkedin-mcp-local", "linkedin-mcp", "serve", "--transport", "stdio"]
    }
  }
}

See the Zed MCP documentation.

Goose

Or add a custom stdio extension with command uvx and arguments --from linkedin-mcp-local linkedin-mcp serve --transport stdio, or start one CLI session with:

goose session --with-extension \
  "uvx --from linkedin-mcp-local linkedin-mcp serve --transport stdio"

See the Goose documentation.

OpenCode

For OpenCode v2, add this to opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "linkedin-mcp": {
        "type": "local",
        "command": ["uvx", "--from", "linkedin-mcp-local", "linkedin-mcp", "serve", "--transport", "stdio"]
      }
    }
  }
}

See the OpenCode MCP documentation.

JetBrains AI Assistant

Open Settings → Tools → AI Assistant → Model Context Protocol (MCP), click Add, set the command to uvx, and set the arguments to --from linkedin-mcp-local linkedin-mcp serve --transport stdio. See the JetBrains MCP documentation.

Continue

Create .continue/mcpServers/linkedin-mcp.json with a local server named linkedin-mcp, command uvx, and arguments --from linkedin-mcp-local linkedin-mcp serve --transport stdio. See the Continue MCP documentation.

Warp

Open Settings → AI → Manage MCP Servers → Add, name the server linkedin-mcp, set the command to uvx, and set the arguments to --from linkedin-mcp-local linkedin-mcp serve --transport stdio. See the Warp MCP documentation.

💡 Examples

Find jobs

Find remote software engineering jobs in India posted on LinkedIn this week with Easy Apply.

Research people

Find LinkedIn profiles for engineering managers at Stripe in India and show me their relevant experience.

Research companies

Find fintech companies in Bengaluru on LinkedIn with 51–200 employees and summarize each company.

Explore posts

Find recent LinkedIn posts about AI agents and summarize the most useful discussions.

Manage your network

Show my latest received connection requests on LinkedIn.

Send a LinkedIn connection request to <profile URL> with the note <note>.

Send messages

Send <message> on LinkedIn to <profile URL>.

🏗️ Architecture

[Claude | Codex | Cursor | ...]
               |
       stdio / loopback HTTP
               v
      [Typed MCP boundary]
               |
               v
       [Fair queue + pacing]
               |
      one operation at a time
               v
[Capability executor] ---> [Process-local calls, cursors, evidence]
               |
               v
      [Capability page objects]
               |
               v
[Browser manager: fresh page per call] <--> [Persistent auth profile]
               |
        visible web UI only
               v
           [LinkedIn]

Everything runs locally. There is no hosted backend, telemetry, database, external queue, LangGraph runtime, or credential service. Browser cookies live only in the local Playwright profile. The first client starts one shared local runtime; later clients attach to it, and fair scheduling gives each client a turn between complete tool calls. Operation state lasts only for that runtime. Read the full architecture and privacy policy.

🔒 Privacy Policy

The server has no maintainer-operated backend, analytics, advertising, or telemetry. LinkedIn receives normal visible-UI requests, and the invoking MCP client receives tool results under its own data policy; the project sends nothing to the maintainer. Read the complete privacy policy for processing, storage, sharing, retention, and deletion details.

🛡️ Safety

Use of this software is at your own risk. You are solely responsible for complying with LinkedIn's User Agreement, applicable laws, and third-party rights. LinkedIn may limit or restrict accounts that use prohibited automation. The maintainers do not authorize spam, unauthorized data collection, privacy violations, or circumvention of access controls.

• Use only accounts and activity you are authorized to operate.
• The server pauses on authentication expiry, checkpoints, restriction pages, permission failures, and configuration errors.
• It does not implement CAPTCHA bypass, proxy rotation, fingerprint spoofing, credential harvesting, stealth plugins, or private LinkedIn endpoints.
• Never commit or share the persistent browser profile or local assets.

See SECURITY.md and the security design.

📚 More documentation

• Configuration
• Capability matrix
• Architecture
• Testing
• Collection verification
• Distribution and registry coverage
• Publishing
• Changelog

❤️ Support the project

If LinkedIn MCP Server is useful to you:

• Star the repository
• Sponsor continued development

🌐 Let's connect

Have feedback or an idea for LinkedIn MCP Server?

• Connect with me on LinkedIn
• Follow me on GitHub
• Report a bug or request a feature

⚖️ License

Licensed under the Apache License 2.0.