linkedin-pages-mcp

MCP server for LinkedIn organization (Company Page) analytics via LinkedIn's Community Management API — follower growth and demographics, page views, post/share engagement, and video stats, surfaced to your AI assistant for analysis the native dashboard can't do.

Built for Claude Code and any MCP-compatible AI tool. Part of The SEO Engine toolkit by Lantern Row.

Scope & data policy

This server is intentionally read-only and limited to aggregate Page reporting data — the category LinkedIn permits storing for up to a year. It does not retrieve individual member-level data (who liked/commented and their profiles), which LinkedIn restricts to short-lived, in-app-only display and prohibits exporting. Keeping to aggregate Page metrics is both the compliant path and the genuinely useful one for trend analysis. There are no posting/write tools.

Access requirements (important)

Unlike most MCPs, this needs an approved LinkedIn developer app:

1. A LinkedIn developer app owned by a registered business, associated with and verified by your Company Page.
2. Approval for the Community Management API (Development tier to build, Standard tier for production — the latter requires a screencast demo).
3. A Page admin completes the 3-legged OAuth flow to produce an access token.

See LinkedIn's app review process. Organic Page analytics is a supported use case; there is no follower minimum or partner-status gate, but approval is a manual review.

Configuration

{
  "mcpServers": {
    "linkedin-pages": {
      "command": "npx",
      "args": ["-y", "linkedin-pages-mcp"],
      "env": {
        "LINKEDIN_ACCESS_TOKEN": "your_3legged_member_token",
        "LINKEDIN_CLIENT_ID": "your_app_client_id",
        "LINKEDIN_CLIENT_SECRET": "your_app_client_secret",
        "LINKEDIN_REFRESH_TOKEN": "your_refresh_token",
        "LINKEDIN_ORGANIZATION_ID": "1234567"
      }
    }
  }
}

LINKEDIN_ACCESS_TOKEN is the only hard requirement; the client id/secret/refresh trio enables automatic token refresh (access tokens last ~60 days).

Tools

Tool	Description
check_connection	Verify the token; list Company Pages you administer.
list_organizations	Company Pages the authenticated member can manage.
get_organization	Page profile + total follower count.
get_follower_statistics	Follower growth + demographic breakdowns (seniority, function, industry, size, geo).
get_page_statistics	Page views / unique visitors by section and device.
get_share_statistics	Organic post impressions, clicks, reactions, comments, shares, engagement rate.
list_posts	An organization's posts (content + metadata).
refresh_token	Mint a fresh access/refresh token pair to persist into your .env.

Statistics tools accept an optional start_ms/end_ms time range with DAY/WEEK/MONTH granularity; omit the range for lifetime/aggregate figures.

Notes

• Versioned API: requests send Linkedin-Version (default 202606). LinkedIn sunsets versions roughly yearly — bump LINKEDIN_VERSION when migrating.
• Security: credentials come from environment variables only; the bearer token is never logged.

License

MIT © Lantern Row