linkedin-company-admin-mcp

Language: English - Romana

MCP server for LinkedIn Company Page administration. Read analytics, manage posts, edit page details, grow followers, and bridge your personal profile for employee advocacy workflows.

Complementary to stickerdaniel/linkedin-mcp-server. Stickerdaniel's project covers personal LinkedIn use cases (feed, messaging, search). This project fills the gap nobody else fills: full administrative control of your LinkedIn Company Page, plus a small set of personal-profile bridge tools used exclusively for employee-advocacy flows.

⚠️ Terms of Service & account risk. LinkedIn's User Agreement prohibits automated access to the platform. This server drives a real browser session on your behalf and LinkedIn may detect, rate-limit, or permanently restrict accounts that use it - including loss of access to the Company Page itself. Use at your own risk. Do not use this on a personal or business account you cannot afford to lose. There is no way for the authors to recover a restricted account for you. Prefer LinkedIn's Community Management API if you qualify for it.

🔐 Security note - session dir equals credentials. "No credentials stored" means this server never asks for your password and never puts one in a config file. It does not mean the profile directory is safe to share. After login, ~/.linkedin-company-admin/profile contains LinkedIn session cookies that are functionally equivalent to your password + 2FA combined. Anyone who reads that directory gets full admin access to your account and Company Page. In particular: do not sync this directory to OneDrive / iCloud / Dropbox / any cloud backup. Keep it on local disk only, on a machine you trust.

Why this project

LinkedIn's official Community Management API is invite-only. Scraping personal profiles is already well covered. What was missing: a stable, browser-first MCP that lets a page admin (or their assistant LLM) read analytics, draft posts, edit the about section, invite followers, and tag the page from a personal post - without any of it touching a stored password.

Features at a glance

• 24 MCP tools across 6 categories - see Tool reference below.
• Zero credentials on disk. Interactive login via a visible Chromium window; session lives in a persistent profile directory (chmod 0o700 on Unix).
• Stealth Chromium via Patchright (anti-detection fork of Playwright).
• Provider abstraction (AdminProvider, PostsProvider) so a future Community Management API backend can slot in without rewriting tools.
• Rate limiting actually applied (not just imported) - every write tool has a conservative hourly cap.
• aria-label / role / innerText selectors only - no obfuscated CSS class hashes. When LinkedIn ships a new UI, only selectors/__init__.py changes.
• No god-files (cap ~300 LOC per file), type-checked with mypy, linted with ruff.

Installation

Option 1: uvx (recommended)

Published on PyPI as linkedin-company-admin-mcp.

uvx linkedin-company-admin-mcp@latest --login

Then add to your Claude Desktop config (~/.config/Claude/claude_desktop_config.json or platform equivalent):

{
  "mcpServers": {
    "linkedin-company-admin": {
      "command": "uvx",
      "args": ["linkedin-company-admin-mcp@latest"]
    }
  }
}

Option 2: Local development

git clone https://github.com/negrueu/linkedin-company-admin-mcp.git
cd linkedin-company-admin-mcp
uv sync
uv run linkedin-company-admin-mcp --login

Option 3: Docker

docker build -t linkedin-company-admin-mcp .
docker run --rm -it \
  -v linkedin_profile:/home/mcp/.linkedin-company-admin \
  linkedin-company-admin-mcp --login

First-time login

Credentials are never stored in this server. Login is interactive:

uvx linkedin-company-admin-mcp --login

A visible Chromium window opens. Sign in to LinkedIn normally (including 2FA). The persistent browser profile is saved to ~/.linkedin-company-admin/profile (chmod 0o700 on Unix). All subsequent MCP calls reuse this session automatically.

To log out: uvx linkedin-company-admin-mcp --logout (wipes the profile directory).

Tool reference

Full argument lists and examples live in docs/TOOL_REFERENCE.md. Summary:

Session (3)

Tool	Purpose
session_status	Is the persistent profile live and logged in?
session_warmup	Pre-open the browser + /feed/ to reduce first-call latency.
session_logout	Close the browser and wipe the profile directory.

Company read (6)

Tool	Purpose
company_read_page	Name, tagline, followers, about, industry, website.
company_list_posts	Recent posts with URN, text, reactions, comments.
company_list_followers	Followers list (admin-only; paginated).
company_list_mentions	Posts that mentioned the page (admin notifications).
company_manage_admins	List admins and their roles.
company_analytics	Followers / posts metrics for a 7d / 28d / 90d window.

Company admin write (3)

Tool	Purpose
company_edit_about	Update the About section (with tagline fallback).
company_edit_logo	Upload a new logo (and optional banner).
company_update_details	Website, industry, size, specialties.

Company content (6)

Tool	Purpose
company_create_post	Publish a text post (optional link / image).
company_edit_post	Replace the body of an existing post.
company_delete_post	Permanent delete - see docs/RCA_DELETE_POST.md.
company_schedule_post	Publish at a future ISO-8601 datetime.
company_reply_comment	Reply as the page to a comment on one of your posts.
company_reshare_post	Reshare another post on the page, optional commentary.

Company growth (2)

Tool	Purpose
company_invite_to_follow	Send follow invitations to 1st-degree connections (LinkedIn caps 250/month).
company_list_scheduled	List posts queued for future publication.

Personal -> Company bridge (4)

Tool	Purpose
personal_tag_company	Publish a personal post that @-mentions the page.
personal_reshare_company_post	Reshare a page post on your personal profile.
personal_comment_as_admin	Comment on a page post as the page (or as you).
personal_read_company_mentions	Scan your recent activity for posts that tag the page.

Security model

• No email/password handling. Credentials never touch this code.
• Session state lives in a persistent browser profile directory, isolated per OS user, outside the repo.
• .env contains only configuration (log level, transport, tool timeout). No secrets.
• The profile directory is chmod'd to 0o700 on first login (Unix).
• Rate limiting is enforced per-tool; the caps are conservative by design, tuned to what LinkedIn tolerates rather than what it allows.

Supported workflows

• Draft, review, and publish a post on your company page from Claude.
• Tag the page from a personal post and track how the community responds.
• Audit who has posted about your page this week (admin mentions).
• Invite a batch of 1st-degree connections to follow the page, stopping at LinkedIn's monthly quota.
• Run a full CRUD pass on scheduled posts before a launch.

See docs/TOOL_REFERENCE.md for end-to-end examples.

Troubleshooting

Selector drift, captcha, rate limits, cookie expiry and Chromium launch issues are all covered in docs/TROUBLESHOOTING.md.

Contributing

Contributions welcome. See docs/CONTRIBUTING.md for local setup, test layout, and the workflow for adding a new tool.

Status

Under active development. See CHANGELOG.md for version history and issues for the roadmap.

License

MIT