AL

agency42/linkedin-mcp

Developer tools
33 stars 0 forks Quality 90 Trend 90

A Model Context Protocol (MCP) server using the TypeScript SDK for LinkedIn integration. Allows an AI agent (e.g. Claude) to authenticate with LinkedIn and share posts or links.

Overview

A Model Context Protocol (MCP) server using the TypeScript SDK for LinkedIn integration. Allows an AI agent (e.g. Claude) to authenticate with LinkedIn and share posts or links.

README

LinkedIn MCP Server

A Model Context Protocol (MCP) server using the TypeScript SDK for LinkedIn integration. Allows an AI agent (e.g. Claude) to authenticate with LinkedIn and share posts or links.

Prerequisites

  • Node.js (>=14) and npm
  • LinkedIn Developer App:
    • Create an app at https://www.linkedin.com/developers/apps
    • Under “Products”, add Sign In with LinkedIn (OpenID Connect) and Share on LinkedIn
    • Authorized Redirect URI must match .env: http://localhost:8000/auth/linkedin/callback
    • Copy your Client ID and Client Secret into .env

Setup

git clone 
cd linkedin-mcp
npm install

Create a .env in project root with:

SESSION_SECRET=your-session-secret
AUTH_PORT=8000          # OAuth callback server port
HTTP_PORT=8001          # HTTP/SSE server port
LINKEDIN_CLIENT_ID=your-client-id
LINKEDIN_CLIENT_SECRET=your-client-secret
LINKEDIN_REDIRECT_URI=http://localhost:8000/auth/linkedin/callback

Running

  1. OAuth Callback Server (must stay running):

    npm run dev:auth
    
  2. MCP Server:

    • Via Claude Desktop:
      claude-desktop
      
    • Or manually:
      npm run dev
      
    • This starts stdio transport + HTTP+SSE server.
  3. Inspector UI:

    npm run build
    npx @modelcontextprotocol/inspector node build/server.js
    
    • Open the Inspector in browser → Tools
    • Use linkedin-share-post or linkedin-share-link tools.

Testing

  1. Visit http://localhost:8000/auth/linkedin in browser → complete LinkedIn login.
  2. Confirm “Authentication successful!”.
  3. In Inspector, run sample post/link tools.
  4. Verify content on your LinkedIn profile.

Claude Desktop Integration

  1. Run npm run dev:auth
  2. Visit http://localhost:8000/auth/linkedin in browser → complete LinkedIn login.
  3. Confirm “Authentication successful!”. A token file should be generated. Do not close this terminal.
  4. Open Claude Desktop and verify the tools are listed

Configure your claude_desktop_config.json file:

{
  "mcpServers": {
    "linkedin": {
      "command": "node",
      "args": ["/Users/ken/Desktop/lab/linkedin-mcp/build/server.js"],
      "transport": "http",
      "url": "http://localhost:8001",
      "sseEndpoint": "/stream",
      "httpEndpoint": "/message",
      "env": {
        "SESSION_SECRET": "your-session-secret",
        "AUTH_PORT": "8000",
        "HTTP_PORT": "8001",
        "LINKEDIN_CLIENT_ID": "your-client-id",
        "LINKEDIN_CLIENT_SECRET": "your-client-secret",
        "LINKEDIN_REDIRECT_URI": "http://localhost:8000/auth/linkedin/callback"
      }
    }
  },
  "globalShortcut": "Ctrl+Space"
}

(You can find this file from Claude Desktop by going to settings > developer > edit config)

Save and restart Claude Desktop to apply changes.

View this README on GitHub

Install

npx @modelcontextprotocol/inspector node build/server.js

Configuration

{ "mcpServers": { "linkedin": { "command": "node", "args": ["/Users/ken/Desktop/lab/linkedin-mcp/build/server.js"], "transport": "http", "url": "http://localhost:8001", "sseEndpoint": "/stream", "httpEndpoint": "/message", "env": { "SESSION_SECRET": "your-session-secret", "AUTH_PORT": "8000", "HTTP_PORT": "8001", "LINKEDIN_CLIENT_ID": "your-client-id", "LINKEDIN_CLIENT_SECRET": "your-client-secret", "LINKEDIN_REDIRECT_URI": "http://localhost:8000/auth/linkedin/callback" } } }, "globalShortcut": "Ctrl+Space" }