Skip to main content
Glama
linkedin-pages-mcp

linkedin-pages-mcp

by lanternrow

linkedin-pages-mcp

npm version License: MIT

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.

Related MCP server: linkedin-pages-mcp

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

Available Tools

8 tools
check_connectionA

Verify the LinkedIn API token works and list the Company Pages the authenticated member administers. Lightweight call to confirm credentials + access.

Inputs: no named parameters.

get_follower_statisticsA

Follower analytics for a Company Page. Lifetime mode (omit start/end) returns demographic breakdowns by seniority, function, industry, company size, and geography. Time-bound mode returns organic/paid follower gains per bucket.

Inputs: end_ms, start_ms, granularity, organization_id.

get_organizationA

Get a Company Page's profile (name, vanity, description) plus its total follower count.

Inputs: organization_id.

get_page_statisticsA

Page view analytics for a Company Page: views and unique visitors, split by section (overview/careers/jobs/life) and device (desktop/mobile), plus visitor demographics. Lifetime or time-bound (DAY/MONTH).

Inputs: end_ms, start_ms, granularity, organization_id.

get_share_statisticsA

Organic post/share analytics for a Company Page: impressions, unique impressions, clicks, reactions, comments, shares, and engagement rate. Aggregate (omit start/end) or time-bound. Sponsored activity is excluded.

Inputs: end_ms, start_ms, granularity, organization_id.

list_organizationsA

List the Company Pages (organizations) the authenticated member can manage, with their URNs/ids. Use these ids with the analytics tools.

Inputs: no named parameters.

list_postsA

List an organization's posts (content + metadata: text, timestamps, lifecycle, distribution). Take a returned post id and pass it to per-post share statistics for engagement.

Inputs: count, sort_by, organization_id.

refresh_tokenA

Mint a fresh LinkedIn access token (and refresh token) from the configured refresh credentials. Returns the new values to persist into your .env. Requires LINKEDIN_CLIENT_ID, LINKEDIN_CLIENT_SECRET, and LINKEDIN_REFRESH_TOKEN.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 8 tools

    Disambiguation5/5

    Every tool targets a distinct resource or action: connection check, organization listing/details, three separate analytics endpoints (followers, page views, shares), post listing, and token refresh. No two tools could be easily confused.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern (check_connection, list_organizations, get_organization, get_follower_statistics, etc.) using lowercase with underscores. The verbs are clear and consistent with the action performed.

    Tool Count5/5

    With 8 tools, the set is well-scoped for a LinkedIn Pages API server covering authentication, organization management, and analytics. Each tool earns its place without unnecessary duplication or bloat.

    Completeness4/5

    The analytics and read-only surfaces are well covered (followers, page views, shares, posts, org details), but there are minor gaps such as no ability to create or update posts or modify organization settings. However, for an analytics-focused server, these are not critical.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      MCP server for LinkedIn Company Page administration. Enables reading analytics, managing posts, editing page details, growing followers, and bridging personal profile for employee advocacy workflows.
      24
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for managing LinkedIn Company Pages via the official Community Management API. Post content, manage comments, track analytics, and more through the Model Context Protocol.
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for LinkedIn API integration. Enables authentication, profile access, connections, search, messaging, and feed management via OAuth2.
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      A production-ready MCP server for interacting with the LinkedIn API, enabling profile lookup, post creation and deletion, image posting, and organization page management through a secure tool-based interface.
      -