Linkedctl MCP Server

CLI and MCP server for the LinkedIn API

Local serverstdio

What is the Linkedctl MCP server?

CLI and MCP server for the LinkedIn API. That is what the linkedctl mcp server brings to an AI assistant: the same capability, reachable through the Model Context Protocol rather than a separate app or dashboard.

The short version

OAuth2 CLI and MCP server for the LinkedIn API.

  • 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

The tools it exposes

The server publishes 8 tools. What each one is for:

  • Authentication — The Authentication tool exposed by this server
  • Posts — The Posts tool exposed by this server
  • Comments — The Comments tool exposed by this server
  • Reactions — The Reactions tool exposed by this server
  • Organizations — The Organizations tool exposed by this server
  • Analytics — The Analytics tool exposed by this server
  • Media — The Media tool exposed by this server
  • Profiles — Profiles let you manage multiple LinkedIn accounts or configurations. Each profile is stored as a separate YAML file under ~/.linkedctl/:

Getting it running

Installation goes through your MCP client rather than a global install: point it at linkedctl on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.

What it needs from you

Configuration is passed through the environment: YOUR_CLIENT_ID, YOUR_CLIENT_SECRET, YOUR_ACCESS_TOKEN, YOUR_REFRESH_TOKEN, YOUR_TOKEN, LINKEDCTL_CLIENT_ID, LINKEDCTL_CLIENT_SECRET, LINKEDCTL_ACCESS_TOKEN. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

How it compares

Plenty of developer tooling servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Linkedctl's toolset — Authentication, Posts, Comments and 5 more — is a fair guide to whether it matches your workflow. It is maintained by alexey-pelykh; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
AuthenticationThe Authentication tool exposed by this server.
PostsThe Posts tool exposed by this server.
CommentsThe Comments tool exposed by this server.
ReactionsThe Reactions tool exposed by this server.
OrganizationsThe Organizations tool exposed by this server.
AnalyticsThe Analytics tool exposed by this server.
MediaThe Media tool exposed by this server.
ProfilesProfiles let you manage multiple LinkedIn accounts or configurations. Each profile is stored as a separate YAML file under ~/.linkedctl/:

How to install the Linkedctl MCP server

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

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
YOUR_CLIENT_IDConfiguration value read at startup.Optional
YOUR_CLIENT_SECRETCredential the server authenticates with.Yes
YOUR_ACCESS_TOKENCredential the server authenticates with.Yes
YOUR_REFRESH_TOKENCredential the server authenticates with.Yes
YOUR_TOKENCredential the server authenticates with.Yes
LINKEDCTL_CLIENT_IDConfiguration value read at startup.Optional
LINKEDCTL_CLIENT_SECRETCredential the server authenticates with.Yes
LINKEDCTL_ACCESS_TOKENCredential the server authenticates with.Yes

Example prompts to try

  • Use Linkedctl to Authentication.
  • Use Linkedctl to Posts.
  • Use Linkedctl to Comments.

Frequently asked questions

It connects Linkedctl to MCP-compatible AI assistants such as Claude and Cursor, exposing 8 tools (Authentication, Posts, Comments, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Linkedctl directly.