LinkedIn MCP Server

A Model Context Protocol (MCP) server that provides AI agents with read/write access to the LinkedIn API.

Features

• Profile Tools: Fetch user profile and email.

• Post Tools: Create text, link, image, and document posts. Delete posts.

• Media Tools: Upload images and documents to LinkedIn.

• Organization Tools: Fetch organization details, post on behalf of an organization, fetch and delete org posts.

• Social Action Tools: Fetch, create, and delete comments on posts. Add or remove reactions (like, celebrate, etc.).

• Organization Analytics Tools: Get organization page, follower, and share statistics.

Related MCP server: LinkedIn MCP Server

Prerequisites

You need a LinkedIn Access Token. Create an app on the LinkedIn Developer Portal, then either:

• Use the built-in OAuth flow (see Development Setup), or

• Generate a token manually from the developer portal.

Quick Start (npm — recommended)

The easiest way to use this server is via the published npm package. No cloning required.

Install globally

npm install -g @himanshu31shr/linkedin-mcp-server

Then run it:

LINKEDIN_ACCESS_TOKEN=your-token linkedin-mcp-server

Or run directly with npx

LINKEDIN_ACCESS_TOKEN=your-token npx -y @himanshu31shr/linkedin-mcp-server

MCP Client Configuration

Claude Desktop

Add the following to your claude_desktop_config.json:

Using npx (no install needed):

{
  "mcpServers": {
    "linkedin": {
      "command": "npx",
      "args": ["-y", "@himanshu31shr/linkedin-mcp-server"],
      "env": {
        "LINKEDIN_ACCESS_TOKEN": "your-linkedin-access-token"
      }
    }
  }
}

Using a global install:

{
  "mcpServers": {
    "linkedin": {
      "command": "linkedin-mcp-server",
      "env": {
        "LINKEDIN_ACCESS_TOKEN": "your-linkedin-access-token"
      }
    }
  }
}

Using a local clone:

{
  "mcpServers": {
    "linkedin": {
      "command": "node",
      "args": ["/path/to/linkedin-mcp-server/dist/index.js"],
      "env": {
        "LINKEDIN_ACCESS_TOKEN": "your-linkedin-access-token"
      }
    }
  }
}

Cursor

In Cursor's Settings > AI > MCP Servers, add a new server:

• Type: command

• Name: linkedin

• Command: npx -y @himanshu31shr/linkedin-mcp-server

• Environment Variables: Add LINKEDIN_ACCESS_TOKEN with your token.

Antigravity / Windsurf / Other MCP Clients

Use the same pattern — point the MCP client to:

npx -y @himanshu31shr/linkedin-mcp-server

And set the LINKEDIN_ACCESS_TOKEN environment variable.

Available Tools

Development Setup

If you want to contribute or run from source:

1. Clone and install:

   git clone https://github.com/himanshu31shr/linkedin-mcp-server.git
   cd linkedin-mcp-server
   npm install

2. Build:

   npm run build

3. Get a LinkedIn Access Token (automated OAuth flow):

   npm run auth

   Follow the prompts — this will save your LINKEDIN_ACCESS_TOKEN to the .env file automatically.

4. Run locally:

   npm run dev

Scripts

Releasing a New Version

The CD pipeline automatically publishes to npm when a version tag is pushed.

# Bump version (creates commit + tag automatically)
npm version patch   # or: npm version minor / npm version major

# Push commit and tag to trigger publish
git push origin main --tags

The pipeline will:

1. Validate the tag matches package.json version

2. Run lint, tests, and build

3. Publish to npm with provenance

4. Create a GitHub Release with auto-generated notes

License

MIT