io.github.alexey-pelykh/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:

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

4. Start using:

   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

... View full README on GitHub