Linkedin Pro

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

Tests Version Python License Docs

📚 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/[email protected]

# 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

Surface	Count
MCP tools	54 (across 10 families)
REST endpoints	60+
CLI commands	10
Dashboard pages	15 (unified Linear+LinkedIn design system)
Tests	721 passing

---

🖼 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