LinkedIn MCP Pro

LinkedIn automation for AI agents — 54 MCP tools, ban-safety gates, full web dashboard, MIT licensed.

📚 Full documentation · Quickstart · API reference · MCP tools

What is it?

LinkedIn MCP Pro is a Model Context Protocol server that gives any AI agent a complete LinkedIn workflow:

• ✍️ Compose posts (manual / AI / template)

• 📅 Schedule posts via cron-like queue

• 💬 Engage with comments, DMs, mentions

• 🔍 Search jobs with match scoring + auto cover letter

• 📊 Analytics with engagement heatmaps + A/B testing

• 🛡 Ban-safety gates on every write path

It ships with a unified web dashboard (15 pages) and 10 CLI commands.

⚡ Quick start

# Install
pipx install git+https://github.com/horizonbymuneeb/linkedin-mcp-pro.git@v2.3.2

# Start dashboard
linkedin-mcp-web --host 0.0.0.0 --port 8080

# Or run as stdio MCP server for AI agents
linkedin-mcp-pro serve

Open http://localhost:8080 for the dashboard, or wire your agent:

linkedin-mcp-install add claude-desktop    # or cursor, cline, windsurf, zed, ...

Full guide: Quickstart

📊 What's inside

🖼 Dashboard preview

The dashboard at / is a unified shell — same sidebar, topbar, design tokens across every page:

• Workspace: Home, Drafts, Schedule, Engage, Jobs, Analytics

• Account: Connect, Cookies, Profile

• Configure: LLM, Safety, Audit, Install, Settings, Templates

Design system: Linear dark mode (#5e6ad2 accent) + LinkedIn content cards (#0a66c2 brand).

See Dashboard tour for a walkthrough.

🤖 Agent support

Works with any MCP host:

• Claude Desktop (macOS / Linux / Windows)

• Claude Code

• Cursor

• Cline (VS Code)

• Continue.dev

• Windsurf

• Zed

• Open WebUI

• LibreChat

• LobeChat

Full setup: Agent setup guide

🛡 Safety

Every write path runs through a ban-safety gate:

• Daily action caps (per-account configurable)

• Velocity windows (no more than N actions per hour)

• Content pattern checks (LinkedIn spam triggers blocked)

• Duplicate detection (no identical posts within 7 days)

• Rate-limit backoff when LinkedIn throttles

The gate is always on — there is no --unsafe flag. See safety.md.

📦 What ships

linkedin-mcp-pro/
├── linkedin_mcp/                # Core package
│   ├── static/                  # 16 HTML pages + unified shell
│   ├── jobs/                    # Jobs module (CV, search, apply, tracker)
│   ├── tools/                   # 17 tool modules
│   ├── cli*.py                  # 10 CLI entry points
│   └── web.py                   # FastAPI server
├── tests/                       # 721 tests
├── scripts/
│   └── e2e_test.py             # Full E2E smoke test (64 checks)
├── docs/                        # MkDocs Material documentation
├── mkdocs.yml                   # Docs build config
├── install.sh / install.ps1     # One-line installers
└── README.md                    # This file

🧪 Development

git clone https://github.com/horizonbymuneeb/linkedin-mcp-pro.git
cd linkedin-mcp-pro
pip install -e .
pytest tests/                    # 721 tests
python scripts/e2e_test.py       # E2E smoke (64 checks)

# Build docs locally
pip install mkdocs mkdocs-material pymdown-extensions
mkdocs serve                     # → http://127.0.0.1:8000

📄 License

MIT © horizonbymuneeb

See LICENSE.

🔗 Links

• 📚 Documentation

• 🐛 Issue tracker

• 💬 Discussions

• 🚀 Releases