Linkedin MCP Server

CClarity LinkedIn MCP

Connect your AI (Claude, ChatGPT, Cursor, or any MCP client) to your LinkedIn data via CClarity.

• Remote MCP API: https://api.cclarity.io/mcp (Streamable HTTP, OAuth-gated)
• Dashboard: get.cclarity.io

---

Quick start (30 seconds)

npx -y @cclarity-packages/cli@latest init

This writes .mcp.json to your project and sets up @cclarity-packages/mcp as the stdio proxy. Restart your IDE and say "Login me into CClarity".

What you can ask after login

"Login me into CClarity"
"Who engaged with my LinkedIn posts this week?"
"Show my post performance for the last 30 days"
"Who viewed my profile recently?"
"Draft a post about X and check viral predictor benchmarks"
"List my pending incoming connection requests"

---

How it works

Your IDE (Claude / Cursor)
  └─▶ @cclarity-packages/mcp  (stdio proxy, this repo)
        └─▶ browser OAuth login → https://api.cclarity.io/mcp
              └─▶ LinkedIn data, who-engaged, ICP scoring

Package	Role
@cclarity-packages/cli	init — writes IDE config once
@cclarity-packages/mcp	Stdio MCP process + browser login

---

Requirements

• Node.js 18+
• A free CClarity account — the MCP gates on active paid subscription + LinkedIn connected
• Paid plan for full tool access (gates return PAYMENT_REQUIRED / UNIPILE_REQUIRED otherwise)

---

Server config (manual)

If you prefer manual configuration instead of init:

Claude Code (.mcp.json):

{
  "mcpServers": {
    "cclarity": {
      "command": "npx",
      "args": ["-y", "@cclarity-packages/mcp", "cclarity-mcp"],
      "env": { "CCLARITY_MCP_URL": "https://api.cclarity.io" }
    }
  }
}

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "cclarity": {
      "command": "npx",
      "args": ["-y", "@cclarity-packages/mcp", "cclarity-mcp"],
      "env": { "CCLARITY_MCP_URL": "https://api.cclarity.io" }
    }
  }
}

---

Available tools (after login + paid plan)

Local tools (stdio package only)

Tool	Description
cclarity_login	Browser OAuth login — stores token locally
cclarity_logout	Clear local credentials
cclarity_status	Auth state + upstream tool count

Remote tools (proxied from api.cclarity.io/mcp)

billing is gate-exempt — it works before payment to give you a Checkout URL. All other tools require an active paid subscription + LinkedIn connected.

Tool	Description
billing	Plan status; live Stripe Checkout (subscribe) or Billing Portal (manage) URL
get_user_context	Your profile, ICP, writing style, and content preferences as markdown
update_profile	Update profile / ICP / writing style / content preferences mid-chat
get_post_performance	Own LinkedIn posts with impressions, reactions, comments, and shares
get_viral_post_predictor	User-relative viral tiers (high/typical/low), content patterns, optional draft scoring
get_profile_viewers	People who viewed your LinkedIn profile (synced twice daily)
get_my_activity_engagements	People you reacted to or commented on — your outbound warm contacts
get_my_followers	Your LinkedIn followers; highlights newly detected
get_who_engaged	People who reacted, commented, or replied on your posts (inbound engagers)
get_my_received_invitations	Incoming LinkedIn connection requests
get_my_sent_invitations	Outgoing LinkedIn connection requests
linkedin_post_publish	Publish a text post to LinkedIn (daily cap; confirm: true required)

---

Data freshness (typical)

Data	Staleness
Own posts / viral predictor	≤ 12 h
Profile viewers	≤ 12 h
Outbound activity / invitations	≤ 12 h
Who engaged	≤ 24 h
Followers	≤ 24 h
Publish	Live

---

Remote MCP endpoint

The hosted API at https://api.cclarity.io/mcp uses Streamable HTTP transport and OAuth authentication. Direct GET /mcp without a bearer token returns 401 by design — use @cclarity-packages/mcp as the stdio proxy to handle login.

Well-known discovery: https://api.cclarity.io/.well-known/mcp/server-card.json

---

Packages in this repo

packages/
├── cli/    → @cclarity-packages/cli   (binary: cclarity)
└── mcp/    → @cclarity-packages/mcp  (binary: cclarity-mcp)

---

Contributing

See CONTRIBUTING.md for the sync policy between this repo and the private cclarity-be monolith.

Security

See SECURITY.md to report vulnerabilities.

License

MIT