Linkedctl

OAuth2 CLI and MCP server for the LinkedIn API.

What It Does

• Post content — text, images, video, documents, articles, multi-image carousels, and polls
• Comments & reactions — create, list, and delete comments and reactions on posts
• Organization support — post, comment, react, and view analytics as an organization
• Analytics — per-post, per-member, and per-organization statistics
• Media uploads — upload images, video, and documents to LinkedIn
• Draft posts — save posts as drafts before publishing
• OAuth 2.0 authentication with your own LinkedIn app
• Direct token passing for tokens obtained from other applications
• MCP server for AI assistant integration (Claude, Cursor, etc.)
• CLI for scriptable LinkedIn operations

Prerequisites

• Node.js >= 24
• A LinkedIn Developer App with appropriate permissions

Installation

npm install -g linkedctl

Or run directly:

npx linkedctl --help

Quick Start

1. Create a LinkedIn app at linkedin.com/developers
2. Configure OAuth 2.0 credentials
3. Authenticate:
   sh

   Copy

   linkedctl auth login --client-id YOUR_CLIENT_ID --client-secret YOUR_CLIENT_SECRET
   

4. Start using:
   sh

   Copy

   linkedctl post "Hello from LinkedCtl!"
   

See the OAuth Setup Guide for detailed step-by-step instructions.

MCP Integration

MCP Client Configuration

{
    "mcpServers": {
        "linkedctl": {
            "command": "npx",
            "args": ["linkedctl", "mcp"]
        }
    }
}

claude mcp add linkedctl -- npx linkedctl mcp

{
    "mcpServers": {
        "linkedctl": {
            "command": "npx",
            "args": ["linkedctl", "mcp"]
        }
    }
}

{
    "mcpServers": {
        "linkedctl": {
            "command": "npx",
            "args": ["linkedctl", "mcp"]
        }
    }
}

Available Tools

All tools accept an optional profile parameter to select a configuration profile.

Authentication

Posts

post_create supports rich content types:

Comments

Reactions

Organizations

Analytics

Media

Configuration

Config File Format

LinkedCtl stores configuration in YAML files. Each file represents a single profile:

api-version: "202601"
oauth:
    client-id: "YOUR_CLIENT_ID"
    client-secret: "YOUR_CLIENT_SECRET"
    access-token: "YOUR_ACCESS_TOKEN"
    refresh-token: "YOUR_REFRESH_TOKEN"
    token-expires-at: "2026-05-03T12:00:00.000Z"

Available keys:

Config files are written with 0600 permissions (owner read/write only).

File Location and Precedence

Without a profile, LinkedCtl searches for config files in this order:

1. .linkedctl.yaml in the current working directory
2. ~/.linkedctl.yaml in the home directory

The first file found is used. When writing (e.g. after auth login), LinkedCtl writes to the CWD file if it exists, otherwise to the home directory file.

Profiles

Profiles let you manage multiple LinkedIn accounts or configurations. Each profile is stored as a separate YAML file under ~/.linkedctl/:

Use the --profile flag with any command:

linkedctl --profile work auth login --client-id ID --client-secret SECRET
linkedctl --profile work post "Hello from my work account!"