linkedin-mcp

LinkedIn MCP server — read your profile, publish posts, and manage your LinkedIn presence from Cursor, Claude Desktop, or any MCP-compatible AI client. Single Rust binary, no runtime required.

Step 1 — Create a LinkedIn Developer App

1. Go to LinkedIn Developer Portal and click Create app
2. Fill in app name, associate it with a LinkedIn Page, and accept terms
3. Under Auth tab → OAuth 2.0 settings, add this redirect URL:

   http://127.0.0.1:9876/callback
   

4. Under Products tab, request Sign In with LinkedIn using OpenID Connect (approved instantly)
5. Go back to Auth tab and copy your Client ID and Client Secret

That's it — you now have everything needed to authenticate.

Step 2 — Install

npm install -g @kembec/linkedin-mcp

Or run without installing:

npx -y @kembec/linkedin-mcp auth

Step 3 — Authenticate

export LINKEDIN_CLIENT_ID="your-client-id"
export LINKEDIN_CLIENT_SECRET="your-client-secret"
linkedin-mcp auth

Your browser opens automatically. Log in to LinkedIn, click Allow, and the token is saved. Done.

To use multiple accounts:

linkedin-mcp auth work
linkedin-mcp auth personal

Tokens are stored at ~/.config/kembec/linkedin-mcp/tokens/ with permissions 0600. Credentials are never written to disk.

Step 4 — Configure your AI client

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "linkedin": {
      "command": "npx",
      "args": ["-y", "@kembec/linkedin-mcp"],
      "env": {
        "LINKEDIN_CLIENT_ID": "your-client-id",
        "LINKEDIN_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "linkedin": {
      "command": "npx",
      "args": ["-y", "@kembec/linkedin-mcp"],
      "env": {
        "LINKEDIN_CLIENT_ID": "your-client-id",
        "LINKEDIN_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Codex CLI

Add to ~/.codex/config.toml:

[mcp_servers.linkedin]
command = "npx"
args = ["-y", "@kembec/linkedin-mcp"]

[mcp_servers.linkedin.env]
LINKEDIN_CLIENT_ID = "your-client-id"
LINKEDIN_CLIENT_SECRET = "your-client-secret"

Available tools

Profile & posts (standard access — no partner approval needed)

Tool	Description
get-profile	Your profile: name, email, profile picture URL
create-post	Publish a text post. Params: text (required), visibility (PUBLIC or CONNECTIONS, default PUBLIC)
get-own-posts	List your recent posts. Params: count (default 10), start (default 0)
delete-post	Delete a post by post ID or full URN
get-company	Organization details by org_id
manage-accounts	List or remove stored OAuth tokens. Params: action (list or remove), account (for remove)

Tools that require LinkedIn Partner approval

These tools are implemented and return a descriptive error if your app lacks the required scope. Apply at LinkedIn Developer — Product catalog.

Tool	Required scope	Description
get-connections	r_network	List 1st-degree connections
search-jobs	r_jobs	Search job postings by keywords and location
send-message	w_messages	Send a direct message to a member URN

Tools not available in the standard API

Tool	Notes
search-people	Requires Recruiter, Talent Hub, or Sales Navigator — not part of the standard member API

Environment variables

Variable	Required	Description
LINKEDIN_CLIENT_ID	Yes	OAuth app client ID
LINKEDIN_CLIENT_SECRET	Yes	OAuth app client secret
LINKEDIN_OAUTH_PORT	No	Fixed port for the local OAuth callback server (default: dynamic). Set to 9876 if you registered http://127.0.0.1:9876/callback
LINKEDIN_REDIRECT_URI	No	Override the full redirect URI (advanced use)

Building from source

git clone https://github.com/Kembec/linkedin-mcp.git
cd linkedin-mcp
cargo build --release
export LINKEDIN_CLIENT_ID="your-client-id"
export LINKEDIN_CLIENT_SECRET="your-client-secret"
./target/release/linkedin-mcp auth

License

MIT — see LICENSE.