linkedin-pages-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@linkedin-pages-mcp Show follower demographics for last quarter"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
Related MCP server: linkedin-pages-mcp
Access requirements (important)
Unlike most MCPs, this needs an approved LinkedIn developer app:
A LinkedIn developer app owned by a registered business, associated with and verified by your Company Page.
Approval for the Community Management API (Development tier to build, Standard tier for production — the latter requires a screencast demo).
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 |
| Verify the token; list Company Pages you administer. |
| Company Pages the authenticated member can manage. |
| Page profile + total follower count. |
| Follower growth + demographic breakdowns (seniority, function, industry, size, geo). |
| Page views / unique visitors by section and device. |
| Organic post impressions, clicks, reactions, comments, shares, engagement rate. |
| An organization's posts (content + metadata). |
| Mint a fresh access/refresh token pair to persist into your |
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(default202606). LinkedIn sunsets versions roughly yearly — bumpLINKEDIN_VERSIONwhen migrating.Security: credentials come from environment variables only; the bearer token is never logged.
License
MIT © Lantern Row
Available Tools
8 toolscheck_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.
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
Scored across 8 tools
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.
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.
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.
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
Related MCP Connectors
LinkedIn Ads MCP server: run LinkedIn campaigns, ad groups, ads and reports from AI.
Hosted LinkedIn Pages MCP server, with each action switched on or off per account.
Managed LinkedIn MCP server for AI agents: search, connect, message and enrich on accounts you own.
LinkedIn company pages as JSON: industry, size, HQ, followers, and specialties, via hosted MCP.
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP server for LinkedIn Company Page administration. Enables reading analytics, managing posts, editing page details, growing followers, and bridging personal profile for employee advocacy workflows.24MIT
- AlicenseNot gradedqualityDmaintenanceMCP 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.2MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for LinkedIn API integration. Enables authentication, profile access, connections, search, messaging, and feed management via OAuth2.MIT
- FlicenseNot gradedqualityCmaintenanceA 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.-