LinkedIn MCP Server

An MCP (Model Context Protocol) server that lets Claude Code post to LinkedIn, manage drafts, schedule posts, comment, react, and more — all from your terminal.

What It Does

16 tools with a two-step safety system (every publish/delete requires explicit confirmation):

| Tool | What it does | Safety | |------|-------------|--------| | linkedin_auth | OAuth login via browser | — | | linkedin_status | Check connection, token expiry, DB health | Read-only | | linkedin_drafts_list | List all drafts (filter by tag) | Read-only | | linkedin_drafts_get | Get full draft details | Read-only | | linkedin_posts_history | View published post history | Read-only | | linkedin_schedule_list | List scheduled posts | Read-only | | linkedin_drafts_save | Save/update a draft | Requires "CONFIRM" | | linkedin_drafts_delete | Delete a draft | Requires "CONFIRM" | | linkedin_schedule_add | Schedule a draft for publishing | Requires "CONFIRM" | | linkedin_schedule_remove | Cancel a scheduled post | Requires "CONFIRM" | | linkedin_react | React to a post (LIKE, CELEBRATE, etc.) | Requires "CONFIRM" | | linkedin_comment | Comment on a post | Requires "CONFIRM" | | linkedin_post | Publish a post to LinkedIn | Requires "POST IT" | | linkedin_drafts_publish | Publish a saved draft | Requires "POST IT" | | linkedin_delete | Delete a published post | Requires "DELETE IT" | | linkedin_confirm | Confirm any pending action | — |

Setup (5 minutes)

1. Create a LinkedIn Developer App

1. Go to linkedin.com/developers/apps
2. Click Create app
3. Fill in:

• App name: anything (e.g. "My Claude MCP")
• LinkedIn Page: link any company page you admin (or create one)
• App logo: any image

1. Under Auth tab:

• Add redirect URL: http://localhost:8585/callback

1. Under Products tab:

• Request access to Share on LinkedIn and Sign In with LinkedIn using OpenID Connect

1. Copy your Client ID and Client Secret from the Auth tab

2. Clone & Build

git clone <this-repo-url> ~/linkedin-mcp-server
cd ~/linkedin-mcp-server
npm install
npm run build

3. Add to Claude Code

Open your Claude Code settings and add the MCP server. You can do this by running:

claude mcp add linkedin -- node /path/to/linkedin-mcp-server/dist/index.js

Or manually add to your Claude Code settings (~/.claude.json or via the Claude Code UI):

{
  "mcpServers": {
    "linkedin": {
      "command": "node",
      "args": ["/full/path/to/linkedin-mcp-server/dist/index.js"],
      "env": {
        "LINKEDIN_CLIENT_ID": "your_client_id_here",
        "LINKEDIN_CLIENT_SECRET": "your_client_secret_here"
      }
    }
  }
}

Replace /full/path/to/ with the actual path where you cloned the repo.

4. Authenticate

Restart Claude Code, then say:

"authenticate with linkedin"

Claude will call linkedin_auth, which opens a browser window for OAuth. Authorize, and you're done. Token is stored locally at ~/.linkedin-mcp-tokens.json (file permissions: 600).

Usage

Just talk to Claude naturally:

• "Post this to LinkedIn: [your text]"
• "Save this as a draft: [text]"
• "Show me my drafts"
• "Schedule draft X for tomorrow at 3pm"
• "What's my LinkedIn connection status?"
• "React to [post-urn] with CELEBRATE"

Every action that touches LinkedIn requires you to confirm with a keyword. Nothing gets published without your explicit "POST IT".

How It Works

• OAuth 2.0: Starts a local server on port 8585, opens LinkedIn auth in browser, catches the callback
• SQLite storage: Drafts, scheduled posts, and post history stored in ~/.linkedin-mcp/data.db
• Config: Stored in ~/.linkedin-mcp/config.json (scopes, API tier)
• Token: Stored in ~/.linkedin-mcp-tokens.json (auto-expires)
• Safety middleware: Two-step confirmation for all write operations. High-risk actions (post, delete) need specific keywords ("POST IT", "DELETE IT")

Configuration

The server auto-creates ~/.linkedin-mcp/config.json on first run:

{
  "scopes": ["openid", "profile", "w_member_social"],
  "api_tier": "consumer"
}

If you have Community Management API access, change api_tier to "community_management" to unlock comment and reaction tools beyond your own posts.

Requirements

• Node.js 18+
• Claude Code (or any MCP-compatible client)
• A LinkedIn account with a Developer App