Linkedctl
CLI and MCP server for posting, commenting and reading LinkedIn analytics via OAuth
- 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 linkedctlAdd 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 tokenRequiredLINKEDCTL_CLIENT_IDLinkedIn OAuth2 client IDLINKEDCTL_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.
