Skip to content
MCP server

Linkedctl

CLI and MCP server for posting, commenting and reading LinkedIn analytics via OAuth

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, API, self-hosted
Runs
Locally
Version
0.5.0
Listing updated
today

Similar MCP servers

About Linkedctl

Linkedctl is an open-source MCP server for marketing and seo. It runs locally on your machine and is started by your AI client.

The README describes linkedctl as an OAuth 2.0 command-line tool and MCP server for the LinkedIn API. It covers creating and managing posts, comments and reactions, uploading media, saving drafts, and pulling analytics for individual posts, a member's account or an organization page.

You register your own LinkedIn Developer App and authenticate through the browser flow, or pass an access token obtained elsewhere. Credentials can live in YAML config files, named profiles for multiple accounts, or environment variables. Destructive actions such as deleting posts ask for confirmation unless a force flag is passed.

The project suits developers and social media operators who want scripted LinkedIn publishing, or who want an AI assistant such as Claude, Cursor or Windsurf to act on their LinkedIn account through the MCP tools.

Install

Run in a terminal

claude mcp add linkedctl --env LINKEDCTL_ACCESS_TOKEN='<LINKEDCTL_ACCESS_TOKEN>' --env LINKEDCTL_CLIENT_SECRET='<LINKEDCTL_CLIENT_SECRET>' -- npx -y linkedctl

Add to claude_desktop_config.json

{
  "mcpServers": {
    "linkedctl": {
      "command": "npx",
      "args": [
        "-y",
        "linkedctl"
      ],
      "env": {
        "LINKEDCTL_ACCESS_TOKEN": "<LINKEDCTL_ACCESS_TOKEN>",
        "LINKEDCTL_CLIENT_SECRET": "<LINKEDCTL_CLIENT_SECRET>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "linkedctl": {
      "command": "npx",
      "args": [
        "-y",
        "linkedctl"
      ],
      "env": {
        "LINKEDCTL_ACCESS_TOKEN": "<LINKEDCTL_ACCESS_TOKEN>",
        "LINKEDCTL_CLIENT_SECRET": "<LINKEDCTL_CLIENT_SECRET>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "linkedctl": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "linkedctl"
      ],
      "env": {
        "LINKEDCTL_ACCESS_TOKEN": "<LINKEDCTL_ACCESS_TOKEN>",
        "LINKEDCTL_CLIENT_SECRET": "<LINKEDCTL_CLIENT_SECRET>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "linkedctl": {
      "command": "npx",
      "args": [
        "-y",
        "linkedctl"
      ],
      "env": {
        "LINKEDCTL_ACCESS_TOKEN": "<LINKEDCTL_ACCESS_TOKEN>",
        "LINKEDCTL_CLIENT_SECRET": "<LINKEDCTL_CLIENT_SECRET>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "linkedctl": {
      "command": "npx",
      "args": [
        "-y",
        "linkedctl"
      ],
      "env": {
        "LINKEDCTL_ACCESS_TOKEN": "<LINKEDCTL_ACCESS_TOKEN>",
        "LINKEDCTL_CLIENT_SECRET": "<LINKEDCTL_CLIENT_SECRET>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • LINKEDCTL_ACCESS_TOKENLinkedIn OAuth2 access tokenRequired
  • LINKEDCTL_CLIENT_IDLinkedIn OAuth2 client ID
  • LINKEDCTL_CLIENT_SECRETLinkedIn OAuth2 client secret

Tools this server provides (22)

Taken from the project documentation; the running server may differ.

whoami
Show the current user's name, email, and profile picture URL
auth_status
Show authentication status for a profile
auth_revoke
Revoke the access token server-side and clear local credentials
post_create
Create a post on LinkedIn with optional media, poll, or article attachment
post_get
Fetch a single post by URN
post_list
List posts with pagination (supports as_org for organization posts)
post_update
Update the commentary text of an existing post
post_delete
Delete a post by URN
comment_create
Create a comment on a post (supports as_org)
comment_list
List comments on a post
comment_get
Get a specific comment by URN
comment_delete
Delete a comment by URN
reaction_create
Add a reaction to a post (supports as_org)
reaction_list
List reactions on a post
reaction_delete
Remove a reaction from a post (supports as_org)
org_list
List organizations the authenticated user administers
org_get
Fetch a single organization by ID
org_followers
Get the follower count for an organization
stats_post
Get analytics for a single post
stats_me
Get aggregated analytics across all your posts
stats_org
Get share statistics for an organization
document_upload
Upload a document to LinkedIn

What it does

Rich post creation
Publishes text, images, video, documents, articles, multi-image carousels and polls, with drafts supported.
Organization posting
Posts, comments, reacts and reads analytics on behalf of organization pages the user administers.
Post and member analytics
Reports impressions, reach and engagement per post, across all posts, or for an organization.
Multiple profiles
Keeps separate LinkedIn accounts or configurations in named profiles selected with a flag.
MCP server for AI clients
Exposes LinkedIn operations as MCP tools for assistants like Claude Desktop, Claude Code, Cursor and Windsurf.
Scriptable CLI
Offers shell commands with JSON output and bash or zsh completions for automation.

Good for

  • Scheduling or publishing LinkedIn posts from a script or terminal
  • Letting an AI assistant draft and publish posts to a LinkedIn account
  • Tracking post and organization page performance from the command line
  • Managing comments and reactions on posts for a company page

Pricing

Open source

Free and open source under AGPL-3.0; requires your own LinkedIn Developer App.

Linkedctl FAQ

What do I need before using it?

Node.js 24 or later and a LinkedIn Developer App with appropriate permissions. The README links an OAuth setup guide.

How is it installed?

Install globally with npm install -g linkedctl, or run it on demand with npx linkedctl.

Which AI clients does the MCP server work with?

The README gives configuration examples for Claude Desktop, Claude Code, Cursor and Windsurf.

What license does it use?

The project is licensed under AGPL-3.0-only. The README says using it as a CLI tool or MCP server carries no license obligations, while using @linkedctl/core as a library requires the combined work to be AGPL-3.0 or compatible.

Is Linkedctl free?

Yes. Linkedctl is open source, so you can use and self-host it for free.

How do I add Linkedctl to Claude Code?

Run this command in your terminal: claude mcp add linkedctl --env LINKEDCTL_ACCESS_TOKEN='<LINKEDCTL_ACCESS_TOKEN>' --env LINKEDCTL_CLIENT_SECRET='<LINKEDCTL_CLIENT_SECRET>' -- npx -y linkedctl

What are the best alternatives to Linkedctl?

The closest alternatives to Linkedctl are LinkedIn MCP Server and API by Cotlet, Taplio for LinkedIn, LeadShark Apex: LinkedIn MCP, LinkedIn by 1Social and Postbeam.

Where this comes from

  • Description: written from the project's README and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers