# 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

```bash
git clone <repo_url>
cd linkedin-mcp
npm install
```

Create a `.env` in project root with:

```env
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):
   ```bash
   npm run dev:auth
   ```

2. **MCP Server**:
   - Via Claude Desktop:
     ```bash
     claude-desktop
     ```
   - Or manually:
     ```bash
     npm run dev
     ```
   - This starts stdio transport + HTTP+SSE server.

3. **Inspector UI**:
   ```bash
   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:

```json
{
  "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.